Gewusst wie: Importieren von benutzerdefinierten Richtlinienassertionen
Richtlinienassertionen beschreiben die Funktionen und Anforderungen eines Dienstendpunkts. Clientanwendungen können Richtlinienassertionen in Dienstmetadaten nutzen, um die Clientbindung zu konfigurieren oder den Dienstvertrag für einen Dienstendpunkt anzupassen.
Benutzerdefinierte Richtlinienassertionen werden importiert, indem die System.ServiceModel.Description.IPolicyImportExtension-Schnittstelle implementiert und das Objekt in das Metadatensystem übergeben wird oder durch die Registrierung des Implementierungstyps in Ihrer Anwendungskonfigurationsdatei. Implementierungen der IPolicyImportExtension-Schnittstelle müssen den Standardkonstruktor bereitstellen.
So importieren Sie benutzerdefinierte Richtlinienassertionen
Implementieren Sie die System.ServiceModel.Description.IPolicyImportExtension-Schnittstelle auf einer Klasse. Anweisungen hierzu finden Sie in den folgenden Verfahren.
Fügen Sie das benutzerdefinierte Richtlinienimportprogramm durch eines der folgenden Verfahren ein:
Verwenden einer Konfigurationsdatei. Anweisungen hierzu finden Sie in den folgenden Verfahren.
Verwenden einer Konfigurationsdatei mit ServiceModel Metadata Utility Tool (Svcutil.exe). Anweisungen hierzu finden Sie in den folgenden Verfahren.
Programmgesteuertes Einfügen des Richtlinienimportprogramms. Anweisungen hierzu finden Sie in den folgenden Verfahren.
So implementieren Sie die System.ServiceModel.Description.IPolicyImportExtension-Schnittstelle auf einer beliebigen Klasse
Suchen Sie für jedes Richtliniensubjekt, an dem Sie interessiert sind, in der System.ServiceModel.Description.IPolicyImportExtension.ImportPolicy(System.ServiceModel.Description.MetadataImporter,System.ServiceModel.Description.PolicyConversionContext)-Methode die Richtlinienassertionen, die Sie importieren möchten, indem Sie die entsprechende Methode auf dem zur Methode übergebenen System.ServiceModel.Description.PolicyConversionContext-Objekt aufrufen (abhängig vom Umfang der gewünschten Assertion). Im folgenden Codebeispiel wird veranschaulicht, wie die System.ServiceModel.Description.PolicyAssertionCollection.Remove(System.String,System.String)-Methode verwendet wird, um die benutzerdefinierte Richtlinienassertion ausfindig zu machen und diese in einem Schritt aus der Sammlung zu entfernen. Wenn Sie die Entfernen-Methode verwenden, um die Assertion ausfindig zu machen und zu entfernen, müssen Sie Schritt 4 nicht durchführen.
Verarbeiten Sie die Richtlinienassertionen. Beachten Sie, dass das Richtliniensystem keine geschachtelten Richtlinien und wsp:optional normalisiert. Sie müssen diese Konstrukte in der Richtlinienimport-Erweiterungsimplementierung verarbeiten.
Nehmen Sie die Anpassung an der Bindung oder am Vertrag vor, die bzw. der die von der Richtlinienassertion festgelegte Funktion oder Anforderung erfüllt. In der Regel geben Assertionen an, dass eine Bindung eine besondere Konfiguration oder ein bestimmtes Bindungselement erfordert. Nehmen Sie diese Änderungen vor, indem Sie auf die System.ServiceModel.Description.PolicyConversionContext.BindingElements-Eigenschaft zugreifen. Andere Assertionen erfordern, dass Sie den Vertrag ändern. Sie können über die System.ServiceModel.Description.PolicyConversionContext.Contract-Eigenschaft auf den Vertrag zugreifen und diesen ändern. Beachten Sie, dass Ihr Richtlinienimportprogramm möglicherweise mehrere Male für dieselbe Bindung und für denselben Vertrag, aber für unterschiedliche Richtlinienalternativen aufgerufen wird, wenn der Import einer Richtlinienalternative fehlschlägt. Der Code sollte diesem Verhalten gegenüber flexibel sein.
Entfernen Sie die die benutzerdefinierte Richtlinienassertion aus der Assertionsauflistung. Wenn Sie die Assertion nicht entfernen, geht Windows Communication Foundation (WCF) davon aus, dass der Richtlinienimport nicht erfolgreich war und importiert die zugeordnete Bindung nicht. Wenn Sie die System.ServiceModel.Description.PolicyAssertionCollection.Remove(System.String,System.String)-Methode verwendet haben, um die benutzerdefinierte Assertion ausfindig zu machen und diese in einem Schritt aus der Auflistung zu entfernen, müssen Sie diesen Schritt nicht durchführen.
So fügen Sie das benutzerdefinierte Richtlinienimportprogramm mit einer Konfigurationsdatei ins Metadatensystem ein
Fügen Sie den Typ des Importprogramms zum <extensions>-Element innerhalb des <policyImporters>-Elements in der Clientkonfigurationsdatei hinzu.
Verwenden Sie in der Clientanwendung System.ServiceModel.Description.MetadataResolver oder System.ServiceModel.Description.WsdlImporter zur Auflösung der Metadaten. Das Importprogramm wird daraufhin automatisch ausgelöst.
So fügen Sie das benutzerdefinierte Richtlinienimportprogramm mithilfe der Datei Svcutil.exe ins Metadatensystem ein
Fügen Sie den Typ des Importprogramms zum <extensions>-Element innerhalb des <policyImporters>-Elements in der Datei Svcutil.exe hinzu. Über die Option /svcutilConfig können Sie Svcutil.exe darüber hinaus dazu bringen, Typen von Richtlinienprogrammen zu laden, die in einer anderen Konfigurationsdatei gespeichert sind.
Verwenden Sie ServiceModel Metadata Utility Tool (Svcutil.exe), um die Metadaten zu importieren. Das Importprogramm wird daraufhin automatisch ausgelöst.
So fügen Sie das benutzerdefinierte Richtlinienimportprogramm programmgesteuert ins Metadatensystem ein
- Fügen Sie vor dem Import der Metadaten das Importprogramm zur System.ServiceModel.Description.MetadataImporter.PolicyImportExtensions-Eigenschaft hinzu (beispielsweise, wenn Sie System.ServiceModel.Description.WsdlImporter verwenden).
Siehe auch
Referenz
System.ServiceModel.Description.MetadataResolver
System.ServiceModel.Description.WsdlImporter
System.ServiceModel.Description.MetadataResolver