ContractReference Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta un riferimento in un documento di individuazione a una descrizione del servizio.
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
- Ereditarietà
Esempio
#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
Commenti
L'individuazione dei servizi Web XML comporta l'individuazione dei servizi Web disponibili in base a un URL. L'URL punta in genere a un documento di individuazione, che in genere ha un'estensione di file con estensione disco. All'interno di un documento di individuazione vengono forniti riferimenti a informazioni sull'esistenza di servizi Web XML. Questi riferimenti possono fare riferimento alle descrizioni dei servizi, agli schemi XSD (XML Schema Definition Language) o ad altri documenti di individuazione. Questa classe rappresenta un riferimento a una descrizione del servizio.
All'interno di un documento di individuazione, un riferimento a una descrizione del servizio è contenuto all'interno di un contractRef elemento XML. L'elemento contractRef XML ha due attributi: ref e docRef. L'elemento contractRef deve avere uno spazio dei nomi XML corrispondente alla Namespace costante , mentre gli ref attributi e docRef vengono inseriti nelle Ref proprietà e DocRef .
Costruttori
| Nome | Descrizione |
|---|---|
| ContractReference() |
Inizializza una nuova istanza della ContractReference classe utilizzando i valori predefiniti. |
| ContractReference(String, String) |
Inizializza una nuova istanza della ContractReference classe utilizzando i riferimenti forniti a una descrizione del servizio e un servizio Web XML che implementa la descrizione del servizio. |
| ContractReference(String) |
Inizializza una nuova istanza della ContractReference classe utilizzando il riferimento fornito a una descrizione del servizio. |
Campi
| Nome | Descrizione |
|---|---|
| Namespace |
Spazio dei nomi XML per i riferimenti alla descrizione del servizio nei documenti di individuazione. |
Proprietà
| Nome | Descrizione |
|---|---|
| ClientProtocol |
Ottiene o imposta l'istanza di utilizzata in un processo di DiscoveryClientProtocol individuazione. (Ereditato da DiscoveryReference) |
| Contract |
Ottiene un ServiceDescription oggetto che rappresenta la descrizione del servizio. |
| DefaultFilename |
Ottiene il nome del file da utilizzare per impostazione predefinita durante il salvataggio della descrizione del servizio di riferimento. |
| DocRef |
Ottiene o imposta l'URL di un servizio Web XML che implementa la descrizione del servizio a cui fa riferimento nella Ref proprietà . |
| Ref |
Ottiene o imposta l'URL sulla descrizione del servizio a cui si fa riferimento. |
| Url |
Ottiene o imposta l'URL per la descrizione del servizio a cui si fa riferimento. |
Metodi
| Nome | Descrizione |
|---|---|
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ReadDocument(Stream) |
Legge la descrizione del servizio dall'oggetto passato Stream e restituisce la descrizione del servizio. |
| Resolve() |
Scarica il documento a cui si fa riferimento in per Url stabilire se il documento a cui si fa riferimento è valido. (Ereditato da DiscoveryReference) |
| Resolve(String, Stream) |
Risolve se il documento a cui si fa riferimento è valido. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| WriteDocument(Object, Stream) |
Scrive la descrizione del servizio passata nell'oggetto Streampassato. |