Freigeben über

Generieren von WSDL mit dem WCF LOB Adapter SDK

  • Artikel

Während der Entwicklung eines Adapters oder wenn sich die vom LOB-System zurückgegebenen Metadaten ändern, ist es häufig hilfreich, die WSDL (Web Services Description Language) anzuzeigen, die vom Adapter zurückgegeben wird, um zu überprüfen, ob die Metadaten für Ihre Vorgänge ordnungsgemäß generiert wurden. Es gibt mehrere Methoden zum Generieren der WSDL. Dieses Thema enthält Informationen zur Verwendung von svcutil.exe und dem Steuerelement "Durchsuchen der Metadatensuche".

Verwenden von „svcutil.exe“

Svcutil.exe ist ein Im Lieferumfang des Windows SDK enthaltenes Befehlszeilenprogramm, das eine URL und optionale Switches akzeptiert und WSDL zurückgibt. Im Folgenden finden Sie ein Beispiel für die Verwendung von svcutil.exe, um die WSDL des Echoadapters zurückzugeben:

Svcutil.exe “echov2://lobhostname/lobapplication?enableAuthentication=False” /target:metadata

Dadurch werden die Metadaten als Microsoft.Adapters.Samples.Echov2.wsdl gespeichert. Wenn Ihr Adapter über viele Vorgänge verfügt, können Sie auswählen, dass nur die gewünschten Vorgänge zurückgegeben werden, indem Sie "op=OperationName" als Teil des URI verwenden. Im Folgenden finden Sie ein Beispiel für die Verwendung dieser Methode, um nur die EchoStrings-Informationen zurückzugeben:

SvcUtil.exe “echov2://lobhostname/lobapplication?enableAuthentication=False&op=Echo/EchoStrings” /target:metadata

Verwenden des Steuerelements "Durchsuchen der Metadatensuche"

Das Steuerelement "Durchsuchen der Metadatensuche" ist ein Windows-Steuerelement, das in den Assistenten verwendet wird, die im WCF LOB Adapter SDK enthalten sind. Sie können dieses Steuerelement jedem Windows Forms-Projekt in Visual Studio hinzufügen und es verwenden, um Ihren Adapter und die gewünschten Vorgänge auszuwählen und dann die WSDL zu generieren.

  1. Öffnen Sie eine Visual Studio-Eingabeaufforderung.

  2. Wählen Sie im Menü Datei die Option Neu aus, und klicken Sie dann auf Projekt.

  3. Wählen Sie im Dialogfeld Neues Projekt unter Vorlagendie Option Windows-Anwendung aus. Geben Sie einen Projektnamen ein, und klicken Sie dann auf OK.

  4. Öffnen Sie die Toolbox, erweitern Sie Allgemeine Steuerelemente, klicken Sie mit der rechten Maustaste auf die Toolbox, und klicken Sie dann auf Elemente auswählen.

  5. Suchen Sie im Dialogfeld Toolboxelemente auswählen auf der Registerkarte .NET Framework Komponenten nach MetadataUserControl, aktivieren Sie das Kontrollkästchen neben diesem Element, und klicken Sie dann auf OK.

  6. Ziehen Sie aus der Toolbox das MetadataUserControl-Steuerelement auf Form1. Möglicherweise müssen Sie die Größe des Formulars ändern, um das gesamte Steuerelement anzuzeigen. Sie sollten in der Lage sein, das Projekt jetzt auszuführen und zu überprüfen, ob das Steuerelement funktionsfähig ist, sodass Sie einen Adapter und Vorgänge auswählen können.

  7. Um WSDL mithilfe dieses Steuerelements zu generieren, müssen Sie Ihrem Formular Code hinzufügen, um die GetWsdl-Methode dieses Steuerelements aufzurufen. Im folgenden Beispiel wird veranschaulicht, wie GetWsdl aufgerufen und die Daten in einer Datei gespeichert werden:

    private void button1_Click(object sender, EventArgs e)  
{  
   ServiceDescription sd = mdUserControl.GetWsdl();  
   FileStream myFileStream = new FileStream(tbWsdlFileName.Text, FileMode.OpenOrCreate, FileAccess.Write);  
   StreamWriter myStreamWriter = new StreamWriter(myFileStream);  
   sd.Write(myStreamWriter);  
   myStreamWriter.Flush();  
   myStreamWriter.Close();  
   MessageBox.Show("WSDL file " + tbWsdlFileName.Text + " is created.");  
}

Weitere Informationen

Problembehandlung für adapter created using the WCF LOB Adapter SDK