Hi,
mir war gerade mal langweilig, da dachte ich mir, dass ich mal eine (gut) dokumentierte Library mit höchstmöglicher Kompatibilität machen kann. Nur, um zu sehen, was alles dazu gehört.

Name der Library:
WakeOnLan

Beschreibung:
Diese Library stellt (Erweiterungs)Methoden zum Senden von Wake-On-LAN-Signalen bereit.

Es wurde für AnyCPU kompiliert. Außerdem wurde die Assembly mit einem Strong Name signiert und hält alle Microsoft-Regeln der Codeanalyse ein. Demzufolge ist alles, was öffentlich ist, mit XML-Kommentaren versehen und somit IntelliSense-Kompatibel.

Der Stammnamespace ist System.Net. Somit lässt es so verwenden, wie es im Beispiel gezeigt wird.

Alle WOL-Signale kommen über UDP. Standardmäßig ist Port 7 eingestellt. Der Port ist aber per Methodenüberladung änderbar.

Klassendiagramm:

Online-Dokumentation

Anwendungsbeispiel:


Verwendete Programmiersprache:
Früher: Visual Basic .NET (IDE: VS 2012 Professional)
Jetzt: C# 5.0 (IDE: VS 2012 Professional)

Systemanforderungen:
.NET Framework 4.5, 4.0, 3.5 oder 2.0

Download:
- v1.1: WakeOnLan.zip - .NET 3.5 - 42,2 KB
- v1.2: WakeOnLan.zip - .NET 4 Client Profile - 45,2 KB
- v1.4: WakeOnLanLibrary.zip - .NET 2.0, 3.5, 4.5 - 21,4 KB
- v1.5: WakeOnLanLibrary_1.5.zip - .NET 2.0, 3.5, 4.0, 4.5 - 29,2 KB

Online-Dokumentation
GitHub-Repository:
github.com/nikeee/wake-on-lan-library

NuGet:


Lizenz/Weitergabe:
Freeware
WakeOnLan Library von nikeee13 steht unter der GNU General Public License v3.0.

Mich würde freuen, zu hören, wo die Library ihren Einsatz findet. :)

ToDo:

• ?
  

Changelog:

AliveDevil schrieb:

Mein Respekt.

90% der Arbeit war die Dokumentation. Das bisschen Magicpacket ist nicht viel Arbeit. D:

AliveDevil schrieb:

kannst du mir aber mal sagen, in welchen Stadien ich den Rechner aus dem Sleep holen kann?
(Hibernate, Stand-By)

Also gerade habe ich meinen Rechner via (selbstgeschriebener) WP7-App aus dem Hinbernate geholt. In der Arbeit habe ich einen WPF-Client, der auch bei völlig heruntergefahrenen Rechnern funktioniert (sollte es ja auch ;)).
Voraussetzung ist aber immer, dass WOL im BIOS und in den Einstellungen der Netzwerkkarte (im Geräte-Manager) aktiviert ist.

Diese Library kann man aber nicht auf einem WP7 verwenden (da dort z.B. der UdpClient fehlt). Ich habe mir noch mal etwas kompatibles zu WP7 erstellt - besteht daran bedarf?
Außerdem habe ich mir eine zusätzliche Klasse namens "MacAddress" erstellt. Diese kann Adressen aus einem String parsen und hat eine WOL-Methode. Braucht das wer?
Wenn ja, kann ich Euch das Mittwoch(?) noch mal reinstellen.

AliveDevil schrieb:

(wird nicht groß sein, ist vmtl. auch nur ne windos exe ohne Gui die beim Start automatisch den Rechner startet)

Ich habe mir einen kleinen WPF-WOL-Manager geschrieben, bei dem man Clients in eine Liste eintragen und einzeln (oder per Auswahl) hochfahren kann.

AliveDevil schrieb:

Man kann einen Rechner, der im ausgeschalteten Zustand ist, wieder hochfahren. LOL.
Das is doch ma das netteste was ich je gehört habe :P

Das... ist für jeden Systemintegrator standard. ;)
Aber nur, wenn entsprechende Einstellungen getätigt wurden (siehe meine erste Antwort). Außerdem wird es bei WLAN-Rechnern wohl nicht funktionieren... glaube ich jedenfalls.
de.wikipedia.org/wiki/Magic_Packet#Magic_Packet

Alles, was man braucht, ist die MAC-Adresse und eventuell noch das Zielnetz; ansonsten Broadcast in das LAN. ;)

AliveDevil schrieb:

da ich den Rechner wenn dann über WAN starten würde und das ja nicht geht (leider).

Ich sehe dort kein Problem. Du müsstest nur das Portforwarding richtig einstellen. Dann sollte das auch gehen. Ich gehe nicht davon aus, dass man im WAN Broadcast-Packets senden kann. Deshalb brauchst du an der Stelle entweder eine statische IP oder DynDNS. Daran kannst du das Packet dann schicken.
Muss ich mal probieren.

AliveDevil schrieb:

Den WPF-WOL-Manager kannst du ja noch als Erweiterung bzw. als beispielprojekt verteilen. So als How-To-Use.

Mal sehen. :)

Ich habe jetzt das als MAC-Adress-Klasse:


Verbesserungsvorschläge? Überschreibungs-/Implementierungswünsche?

Edit:
Ich habe die Wol-Methoden noch mal in eine extra Extensionmethods-Klasse ausgelagert, da sie ja nicht zur eigentlichen MAC-Adresse gehören.

Übrigens ist mir aufgefallen, dass ich nicht bei jeder Methode dazugeschrieben habe, welche Exceptions ausgelöst werden können. Das kommt dann noch im nächsten Update.

Kennt jemand von Euch etwas, womit man sich eine schöne Dokumentation (so wie bei AForge und MSDN) aus den XML-Daten machen kann?

Ich werde mir Sandcastle mal anschauen.

Bis jetzt habe ich folgendes:


Vorschläge? Verbesserungen?
Langsam wird es unübersichtlich mit den ganzen Overloads - hat da jemand eine Idee, wie man es übersichtlicher machen kann?

picoflop schrieb:

.SendWolAsync ... -> TaskAsync (Async CTP)

Genau daran habe ich auch schon gedacht. Dazu würde ich aber lieber auf das finale .NET 4.5 warten, denn eine CTP produktiv einsetzen finde ich nicht so toll.

picoflop schrieb:

oder "normal" Async (Begin_ End_ bzw _Completed?)

Dazu war ich zu faul. ;)
Deshalb habe ich es wie (z.B.) im .NET 2.0 WebClient gemacht - nur ohne Events. Diese sollten eigentlich auch noch kommen, aber ich war ehrlich gesagt auch dazu zu faul. ;)
Ich überlege auch gerade, ob ich die Async-Sachen auch wieder raus nehme udn es den User selber machen lasse. Aber ich glaube vorher nehme ich lieber die Async CTP.

xtts02 schrieb:

Eine Funktion, MAC und Rechnername aller im LAN (also im selben Subnet) erreichbaren Rechner aufzulisten

Da bin ich mir nicht ganz sicher. Vielleicht ne Art MacAddressQuery-Klasse. Das hat allerdings nicht mehr sehr viel mit dem eigentlichen Zweck (WOL) zu tun. Mal sehen.

xtts02 schrieb:

und zu speichern

Wie picoflop schon sagt - das gehört eher in das Hauptprogramm. Die Klassen sind auch alle als serialisierbar gekennzeichnet. Von daher kann der Library Consumer da machen, wozu er Lust hat. ;)
Woher soll ich (als "Methoden-Bereitsteller") auch wissen, wie der Library-Benutzer das gerne gespeichert haben möchte?

So eine Klasse wäre aber wohl relativ aufwändig, da man nie weiß, in was für einer Umgebung die Anwendung am Ende gestartet wird. sowas würde ich erstmal zurückstellen.