In .NET Compact Framework Messaging

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Die Teilmenge der Windows Communication Foundation (WCF) , die in der .NET Compact Framework implementiert bietet ein vereinheitlichtes Programmiermodell zum Erstellen von meldungsorientiert Anwendungen. Es ermöglicht Entwicklern, sicheren messaging-Anwendungen, die Arbeit über Plattformen hinweg und die Unterstützung Interaktion mit vorhandenen WCF-Dienste auf dem Desktop erstellen.

Hinweis

WCF wird in der .NET compact Framework Version 3.5 und höher unterstützt.

Architektur

Die WCF-Messagingschicht für .NET Compact Framework ist nach standard desktop WCF-Architektur modelliert. Die Messagingschicht wird auf dem Gerät unterstützt und aktiviert das Gerät mit einer vorhandenen WCF-Dienst auf dem Desktop. Die Run-Time-Dienstschicht ist nicht auf dem Gerät vorhanden.

Die folgende Abbildung zeigt den Kanalstapel, zugeordnete Protokolle und WCF-Bindungselemente.

WCF-Messagingschicht .NET Compact Framework

Messaging layer for WCF in .NET Compact Framework

Der WS-Security-Spezifikation Version 1.0 unterstützt SOAP-Nachrichtensicherheit mithilfe von x. 509-Zertifikate.

Message -Klasse baut auf dem Standard WS-Adressierung.

Unterschiede zu der Desktop-Implementierung

.NET Compact Framework unterstützt nicht den vollständigen Satz der Protokolle und Bindungen, die auf dem Desktop unterstützt werden. Finden Sie unter das Architekturdiagramm im vorherigen Abschnitt Weitere Informationen über bestimmte Protokolle und Bindungen, die unterstützt werden.

Die Run-Time-Dienstschicht ist auf .NET Compact Framework nicht unterstützt. Als Ergebnis Wenn Sie eine Verbindung mit einer vorhandenen WCF-Dienst auf dem Desktop herstellen möchten, berücksichtigen Folgendes:

  • Einige Einstellungen in der Datei Web.config müssen geändert werden. Weitere Informationen finden Sie unter SO WIRD'S GEMACHT: Verwenden der HTTP-Transports.

  • Wenn Sie Unterstützung für System.ServiceModel Verträge Geräte hinzufügen möchten, können Sie das .NET Compact Framework ServiceModel-Dienstprogramm-Tool (NetCFSvcUtil.exe), um einen WCF-Clientproxy zu generieren. Dieses Tool implementiert Unterstützung für viele Vertrag-Parameter in der .NET Compact Framework. NetCFSvcUtil.exe ist in der Power Toys für .NET Compact Frameworkenthalten. Weitere Informationen finden Sie unter Power Toys für .NET Framework.

  • Wenn Sie keine NetCFSvcUtil verwenden, können Sie verwenden das WCF ServiceModel Desktop Dienstprogramm-Tool (SvcUtil.exe) und den generierten Code nachträgliche. In diesem Szenario müssen Sie die nicht unterstützte System.ServiceModel Attribute aus dem generierten Code zu entfernen. Weitere Informationen über diese Änderungen und ein Beispiel finden Sie unter SO WIRD'S GEMACHT: Verwenden der HTTP-Transports.

Darüber hinaus sind eine Teilmenge der WCF-messaging-Typen und Member in der vollständigen .NET Framework unterstützt.

Im nächste Abschnitt beschreibt die Unterschiede, die für WCF-Sicherheitsfunktionen spezifisch sind.

Sicherheit

WCF in .NET Compact Framework messaging unterstützt SOAP Nachrichtensicherheit, die eine Teilmenge der WS-Security-Features entspricht und basiert auf x. 509-Zertifikate. WS-Security ist eine Anwendungsschicht, die Sie von allen unterstützten Transport platzieren können. Die Bindung der Elemente, Sicherheit sind in WCF unterstützt messaging, SecurityBindingElement und AsymmetricSecurityBindingElement. Um Sicherheitsfunktionen zu implementieren, müssen Sie die x. 509-Zertifikate innerhalb eines Objekts ClientCredentials für den WCF-Client-Proxy als Parameter in den Konstruktor übergeben.

Sicherheit auf Benutzerebene Transport wird auch für WCF in .NET Compact Framework unterstützt. Dies umfasst Unterstützung für HttpsTransportBindingElement und BasicHttpSecurity.

Die Implementierung von WCF-Sicherheit in der .NET Compact Framework unterscheidet sich in der folgenden Arten von der Implementierung auf dem Desktop:

  • Nur eine Teilmenge der WS-Security Version 1.0 wird unterstützt.

  • Für die Klasse SecurityAlgorithmSuite wird nur die Basic256Rsa15-Eigenschaft aufgrund von Einschränkungen Betriebssystem unterstützt.

  • Nachrichtenkopfzeilen können nicht verschlüsselt werden.

  • BasicHttpSecurityMode wird nicht unterstützt.

Hinweis

Zeiten erweiterte speichern Sommerzeit fehl ausgehende Nachrichten, die Nachrichtensicherheit verwenden aufgrund eines Fehlers Validierung Timestamp Wenn die Überprüfung standardmäßig Timestamp fünf Minuten aktiv ist.Die erweiterte Sommerzeit speichern Zeiten auftreten, zwischen der zweite Sonntag im März und den ersten Sonntag im April und auch zwischen der letzten Sonntag im Oktober und den ersten Sonntag im November.Um dieses Problem zu beheben, installieren Sie das Sommerzeit (DST) 2007-Update.Dies gilt nicht für Geräte, auf denen Windows Mobile 5.0-Build 15096.3.0 ausgeführt wird und höher oder Windows Mobile 6.0 und höher.

Bereitstellung

Die WCF-messaging-DLLs werden in den .NET Compact Framework CAB-Dateien übermittelt. Die verwalteten Assemblys werden im globalen Assemblycache installiert.

Die WCF messaging DLLs für das Gerät die folgenden gehören:

  • System.ServiceModel.dll

  • System.Runtime.Serialization.dll

Die Bereitstellung umfasst auch die Bereitstellung WCF Exchange Server Mail-Transport. Weitere Informationen über das Gerät und desktop Bereitstellung finden Sie unter WCF Exchange Server E-Mail-Transport.

Protokollierung

WCF auf dem desktop .NET Framework unterstützt drei Typen der Protokollierung: Ablaufverfolgung, messaging und Ereignisprotokollierung. WCF auf .NET Compact Framework unterstützt nur Ablaufprotokollierung Code Ausnahmen zu verfolgen, aber es werden keine Warnungen und Fehlermeldungen protokolliert. Ein Registrierungsschlüssel wird zum Konfigurieren der Protokollierung.

WCF-Informationen protokollieren, müssen Sie zuerst Protokollierung für .NET Compact Framework aktivieren. Weitere Informationen zum Aktivieren der Protokollierung und zum Aktivieren Sie des Ablaufverfolgungsprotokoll WCF finden Sie unter SO WIRD'S GEMACHT: Erstellen von Protokolldateien.

Siehe auch

Konzepte

Dateiinformationen protokollieren

Weitere Ressourcen

Windows Communication Foundation (WCF) Entwicklung und .NET Compact Framework