ContractReference Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente une référence à une description de service dans un document de découverte.
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
- Héritage
Exemples
#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
Remarques
La découverte des services Web XML implique la découverte des services Web disponibles en fonction d’une URL. L’URL pointe généralement vers un document de découverte, qui a généralement une extension de nom de fichier .disco. Dans un document de découverte figurent des références à des informations sur l’existence de services Web XML. Ces références peuvent faire référence à des descriptions de service, à des schémas XSD (XML Schema Definition Language) ou à d’autres documents de découverte. Cette classe représente une référence à une description de service.
Dans un document de découverte, une référence à une description de service est contenue dans un contractRef
élément XML. L’élément contractRef
XML a deux attributs : ref
et docRef
. L’élément contractRef
doit avoir un espace de noms XML correspondant à la Namespace constante, tandis que les ref
attributs et docRef
sont placés dans les Ref propriétés et DocRef .
Constructeurs
ContractReference() |
Initialise une nouvelle instance de la classe ContractReference à l'aide de valeurs par défaut. |
ContractReference(String) |
Initialise une nouvelle instance de la classe ContractReference à l'aide de la référence fournie à une description de service. |
ContractReference(String, String) |
Initialise une nouvelle instance de la classe ContractReference à l'aide des références fournies à une description de service et d'un service Web XML implémentant la description de service. |
Champs
Namespace |
Espace de noms XML pour des références de description de services dans des documents de découverte. |
Propriétés
ClientProtocol |
Obtient ou définit l'instance de DiscoveryClientProtocol utilisée dans un processus de découverte. (Hérité de DiscoveryReference) |
Contract |
Obtient un objet ServiceDescription représentant la description de service. |
DefaultFilename |
Obtient le nom du fichier à utiliser par défaut lors de l'enregistrement de la description du service référencé. |
DocRef |
Obtient ou définit l’URL d’un service web XML implémentant la description du service référencée dans la propriété Ref. |
Ref |
Obtient ou définit l'URL de la description du service référencé. |
Url |
Obtient ou définit l'URL de la description du service référencé. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ReadDocument(Stream) |
Lit la description du service à partir du Stream passé et retourne la description du service. |
Resolve() |
Télécharge le document référencé à partir de Url afin de savoir s'il est valide. (Hérité de DiscoveryReference) |
Resolve(String, Stream) |
Indique si le document référencé est valide. |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
WriteDocument(Object, Stream) |
Écrit la description du service passée dans le Stream passé. |