ContractReference Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Representerar en referens i ett identifieringsdokument till en tjänstbeskrivning.
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
- Arv
Exempel
#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
Kommentarer
IDENTIFIERING av XML-webbtjänster omfattar identifiering av tillgängliga webbtjänster med en URL. URL:en pekar vanligtvis på ett identifieringsdokument som vanligtvis har filnamnstillägget a.disco. I ett identifieringsdokument finns referenser till information om förekomsten av XML-webbtjänster. Dessa referenser kan referera till tjänstbeskrivningar, XSD-scheman (XML Schema Definition Language) eller andra identifieringsdokument. Den här klassen representerar en referens till en tjänstbeskrivning.
I ett identifieringsdokument finns en referens till en tjänstbeskrivning i ett contractRef XML-element.
contractRef XML-elementet har två attribut: ref och docRef. Elementet contractRef måste ha ett XML-namnområde som matchar konstanten Namespace , medan attributen ref och docRef placeras i Ref egenskaperna och DocRef .
Konstruktorer
| Name | Description |
|---|---|
| ContractReference() |
Initierar en ny instans av klassen med hjälp av ContractReference standardvärden. |
| ContractReference(String, String) |
Initierar en ny instans av klassen med hjälp av ContractReference de angivna referenserna till en tjänstbeskrivning och en XML-webbtjänst som implementerar tjänstbeskrivningen. |
| ContractReference(String) |
Initierar en ny instans av klassen med hjälp av ContractReference den angivna referensen till en tjänstbeskrivning. |
Fält
| Name | Description |
|---|---|
| Namespace |
XML-namnrymd för tjänstbeskrivningsreferenser i identifieringsdokument. |
Egenskaper
| Name | Description |
|---|---|
| ClientProtocol |
Hämtar eller anger instansen av DiscoveryClientProtocol som används i en identifieringsprocess. (Ärvd från DiscoveryReference) |
| Contract |
Hämtar ett ServiceDescription objekt som representerar tjänstbeskrivningen. |
| DefaultFilename |
Hämtar namnet på filen som ska användas som standard när den refererade tjänstbeskrivningen sparas. |
| DocRef |
Hämtar eller anger URL:en för en XML-webbtjänst som implementerar tjänstbeskrivningen som refereras i Ref egenskapen. |
| Ref |
Hämtar eller anger URL:en till den refererade tjänstbeskrivningen. |
| Url |
Hämtar eller anger URL:en för den refererade tjänstbeskrivningen. |
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ReadDocument(Stream) |
Läser tjänstbeskrivningen från den skickade Stream och returnerar tjänstbeskrivningen. |
| Resolve() |
Laddar ned det refererade dokumentet på Url för att lösa om det refererade dokumentet är giltigt. (Ärvd från DiscoveryReference) |
| Resolve(String, Stream) |
Löser om det refererade dokumentet är giltigt. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| WriteDocument(Object, Stream) |
Skriver beskrivningen av den skickade tjänsten till den skickade .Stream |