ContractReference Klasse

Definition

Stellt einen Verweis in einem Ermittlungsdokument auf eine Dienstbeschreibung dar.

public ref class ContractReference : System::Web::Services::Discovery::DiscoveryReference
public class ContractReference : System.Web.Services.Discovery.DiscoveryReference
type ContractReference = class
    inherit DiscoveryReference
Public Class ContractReference
Inherits DiscoveryReference
Vererbung
ContractReference

Beispiele

#using <System.Xml.dll>
#using <System.Web.Services.dll>

using namespace System;
using namespace System::Xml;
using namespace System::IO;
using namespace System::Web::Services::Discovery;
int main()
{
   try
   {
      
      // Get a DiscoveryDocument.
      DiscoveryDocument^ myDiscoveryDocument = gcnew DiscoveryDocument;
      
      // Get a ContractReference.
      ContractReference^ myContractReference = gcnew ContractReference;
      
      // Set the URL to the referenced service description.
      myContractReference->Ref = "http://localhost/service1.asmx?wsdl";
      
      // Set the URL for an XML Web service implementing the service
      // description.
      myContractReference->DocRef = "http://localhost/service1.asmx";
      SoapBinding^ myBinding = gcnew SoapBinding;
      myBinding->Binding = gcnew XmlQualifiedName( "q1:Service1Soap" );
      myBinding->Address = "http://localhost/service1.asmx";
      
      // Add myContractReference to the list of references contained
      // in the discovery document.
      myDiscoveryDocument->References->Add( myContractReference );
      
      // Add Binding to the references collection.
      myDiscoveryDocument->References->Add( myBinding );
      
      // Open or create a file for writing.
      FileStream^ myFileStream = gcnew FileStream( "Service1.disco",FileMode::OpenOrCreate,FileAccess::Write );
      StreamWriter^ myStreamWriter = gcnew StreamWriter( myFileStream );
      
      // Write myDiscoveryDocument into the passed stream.
      myDiscoveryDocument->Write( myStreamWriter );
      Console::WriteLine( "The Service1.disco is generated." );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Error is {0}", e->Message );
   }

}
using System;
using System.Xml;
using System.IO;
using System.Web.Services.Discovery;

public class MyContractReference
{
   static void Main()
   {
      try
      {
         // Get a DiscoveryDocument.
         DiscoveryDocument myDiscoveryDocument = new  DiscoveryDocument();

         // Get a ContractReference.
         ContractReference myContractReference = new ContractReference();

         // Set the URL to the referenced service description.
         myContractReference.Ref = "http://localhost/service1.asmx?wsdl";

         // Set the URL for an XML Web service implementing the service
         // description.
         myContractReference.DocRef = "http://localhost/service1.asmx";
         SoapBinding myBinding = new SoapBinding();
         myBinding.Binding = new XmlQualifiedName("q1:Service1Soap");
         myBinding.Address = "http://localhost/service1.asmx";

         // Add myContractReference to the list of references contained
         // in the discovery document.
         myDiscoveryDocument.References.Add(myContractReference);

         // Add Binding to the references collection.
         myDiscoveryDocument.References.Add(myBinding);

         // Open or create a file for writing.
         FileStream myFileStream = new FileStream("Service1.disco",
             FileMode.OpenOrCreate, FileAccess.Write );
         StreamWriter myStreamWriter = new StreamWriter( myFileStream );

         // Write myDiscoveryDocument into the passed stream.
         myDiscoveryDocument.Write( myStreamWriter );
         Console.WriteLine("The Service1.disco is generated.");
      }
      catch(Exception e)
      {
         Console.WriteLine("Error is "+ e.Message);
      }
   }
}
Imports System.Xml
Imports System.IO
Imports System.Web.Services.Discovery

Public Class MyContractReference
   Shared Sub Main()
      Try
         ' Get a 'DiscoveryDocument' object.
         Dim myDiscoveryDocument As New DiscoveryDocument()
         ' Get a 'ContractReference' object.
         Dim myContractReference As New ContractReference()
         ' Set the URL to the referenced service description.
         myContractReference.Ref = "http://localhost/service1.asmx?wsdl"
         ' Set the URL for a XML Web service implementing the service
         ' description .
         myContractReference.DocRef = "http://localhost/service1.asmx"
         Dim myBinding As New SoapBinding()
         myBinding.Binding = New XmlQualifiedName("q1:Service1Soap")
         myBinding.Address = "http://localhost/service1.asmx"
         ' Add 'myContractReference' to the list of references contained 
         ' within the discovery document.
         myDiscoveryDocument.References.Add(myContractReference)
         ' Add 'Binding' to referenceCollection.
         myDiscoveryDocument.References.Add(myBinding)
         ' Open or create a file for writing .
         Dim myFileStream As New FileStream("Service1.disco", FileMode.OpenOrCreate, FileAccess.Write)
         Dim myStreamWriter As New StreamWriter(myFileStream)
         ' Write 'myDiscoveryDocument' into the passed stream.
         myDiscoveryDocument.Write(myStreamWriter)
         Console.WriteLine("The 'Service1.disco' is generated.")
      Catch e As Exception
         Console.WriteLine("Error is" + e.Message)
      End Try
   End Sub
End Class

Hinweise

Die ERMITTLUNG von XML-Webdiensten umfasst die Ermittlung der verfügbaren Webdienste, die über eine URL verfügen. Die URL verweist in der Regel auf ein Ermittlungsdokument, das in der Regel über die Dateinamenerweiterung ".disco" verfügt. Innerhalb eines Ermittlungsdokuments sind Verweise auf Informationen über das Vorhandensein von XML-Webdiensten. Diese Verweise können auf Dienstbeschreibungen, XSD-Schemaschemas (XML Schema Definition Language) oder andere Ermittlungsdokumente verweisen. Diese Klasse stellt einen Verweis auf eine Dienstbeschreibung dar.

Innerhalb eines Ermittlungsdokuments ist ein Verweis auf eine Dienstbeschreibung in einem contractRef XML-Element enthalten. Das contractRef XML-Element weist zwei Attribute auf: ref und docRef. Das contractRef Element muss über einen XML-Namespace verfügen, der mit der Namespace Konstante abgleicht, während die ref Attribute docRef in die Ref und DocRef die Eigenschaften eingefügt werden.

Konstruktoren

Name Beschreibung
ContractReference()

Initialisiert eine neue Instanz der ContractReference Klasse mithilfe von Standardwerten.

ContractReference(String, String)

Initialisiert eine neue Instanz der Klasse mithilfe der ContractReference bereitgestellten Verweise auf eine Dienstbeschreibung und einen XML-Webdienst, der die Dienstbeschreibung implementiert.

ContractReference(String)

Initialisiert eine neue Instanz der ContractReference Klasse mithilfe des bereitgestellten Verweises auf eine Dienstbeschreibung.

Felder

Name Beschreibung
Namespace

XML-Namespace für Dienstbeschreibungsverweise in Ermittlungsdokumenten.

Eigenschaften

Name Beschreibung
ClientProtocol

Dient zum Abrufen oder Festlegen der Instanz, die DiscoveryClientProtocol in einem Ermittlungsprozess verwendet wird.

(Geerbt von DiscoveryReference)
Contract

Ruft ein ServiceDescription Objekt ab, das die Dienstbeschreibung darstellt.

DefaultFilename

Ruft den Namen der Datei ab, die standardmäßig beim Speichern der Referenzdienstbeschreibung verwendet werden soll.

DocRef

Dient zum Abrufen oder Festlegen der URL für einen XML-Webdienst, der die Dienstbeschreibung implementiert, auf die in der Ref Eigenschaft verwiesen wird.

Ref

Ruft die URL auf die Referenzdienstbeschreibung ab oder legt sie fest.

Url

Dient zum Abrufen oder Festlegen der URL für die Dienstbeschreibung, auf die verwiesen wird.

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ReadDocument(Stream)

Liest die Dienstbeschreibung aus der übergebenen Stream Und gibt die Dienstbeschreibung zurück.

Resolve()

Lädt das referenzierte Dokument Url herunter, um zu beheben, ob das referenzierte Dokument gültig ist.

(Geerbt von DiscoveryReference)
Resolve(String, Stream)

Behebt, ob das referenzierte Dokument gültig ist.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
WriteDocument(Object, Stream)

Schreibt die übergebene Dienstbeschreibung in die übergebene Stream.

Gilt für:

Weitere Informationen