ContractReference.DocRef-Eigenschaft

Ruft den URL für einen XML-Webdienst ab, der die Dienstbeschreibung implementiert, auf die in der Ref-Eigenschaft verwiesen wird, und legt diesen URL fest.

Namespace: System.Web.Services.Discovery
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Property DocRef As String
'Usage
Dim instance As ContractReference
Dim value As String

value = instance.DocRef

instance.DocRef = value

public string DocRef { get; set; }

public:
property String^ DocRef {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_DocRef ()

/** @property */
public void set_DocRef (String value)

public function get DocRef () : String

public function set DocRef (value : String)

Eigenschaftenwert

Der URL für einen XML-Webdienst, der die Dienstbeschreibung implementiert, auf die in der Ref-Eigenschaft verwiesen wird.

Hinweise

In einem Discoverydokument ist ein Verweis auf eine Dienstbeschreibung in einem contractRef-XML-Element enthalten. Das contractRef-XML-Element verfügt über zwei Attribute, die in der folgenden Tabelle beschrieben werden.

Attribut	Beschreibung
ref	Der URL für die Dienstbeschreibung. Die Ref-Eigenschaft stellt den Wert des ref-Attributs dar.
docRef	Der URL für einen XML-Webdienst, der die Dienstbeschreibung implementiert, die durch das ref-Attribut angegeben wird. Die DocRef-Eigenschaft stellt den Wert des docRef-Attributs dar.

Beispiel

Im folgenden Codebeispiel wird die DocRef-Eigenschaft von ContractReference festgelegt.

' Call the Constructor of ContractReference.
Dim myContractReference As New ContractReference()
Dim myXmlDocument As New XmlDocument()

' Read the discovery document for the 'contractRef' tag.
myXmlDocument.Load("https://localhost/Discoverydoc.disco")

Dim myXmlRoot As XmlNode = myXmlDocument.FirstChild
Dim myXmlNode As XmlNode = myXmlRoot("scl:contractRef")
Dim myAttributeCollection As XmlAttributeCollection = myXmlNode.Attributes

myContractReference.Ref = myAttributeCollection(0).Value
Console.WriteLine("The URL to the referenced service description is : {0}", myContractReference.Ref)
myContractReference.DocRef = myAttributeCollection(1).Value
Console.WriteLine("The URL implementing the referenced service description is : {0}", myContractReference.DocRef)

// Call the Constructor of ContractReference.
ContractReference myContractReference = new ContractReference();
XmlDocument myXmlDocument = new XmlDocument();

// Read the discovery document for the 'contractRef' tag.
myXmlDocument.Load("https://localhost/Discoverydoc.disco");
   
XmlNode myXmlRoot = myXmlDocument.FirstChild;
XmlNode myXmlNode = myXmlRoot["scl:contractRef"]; 
XmlAttributeCollection myAttributeCollection = myXmlNode.Attributes;

myContractReference.Ref = myAttributeCollection[0].Value;
Console.WriteLine("The URL to the referenced service description is : {0}",myContractReference.Ref);
myContractReference.DocRef = myAttributeCollection[1].Value;
Console.WriteLine("The URL implementing the referenced service description is : {0}",myContractReference.DocRef);

// Call the Constructor of ContractReference.
ContractReference^ myContractReference = gcnew ContractReference;
XmlDocument^ myXmlDocument = gcnew XmlDocument;

// Read the discovery document for the 'contractRef' tag.
myXmlDocument->Load( "https://localhost/Discoverydoc.disco" );
XmlNode^ myXmlRoot = myXmlDocument->FirstChild;
XmlNode^ myXmlNode = myXmlRoot[ "scl:contractRef" ];
XmlAttributeCollection^ myAttributeCollection = myXmlNode->Attributes;
myContractReference->Ref = myAttributeCollection[ 0 ]->Value;
Console::WriteLine( "The URL to the referenced service description is : {0}", myContractReference->Ref );
myContractReference->DocRef = myAttributeCollection[ 1 ]->Value;
Console::WriteLine( "The URL implementing the referenced service description is : {0}", myContractReference->DocRef );

// Call the Constructor of ContractReference.
ContractReference myContractReference = new ContractReference();
XmlDocument myXmlDocument = new XmlDocument();

// Read the discovery document for the 'contractRef' tag.
myXmlDocument.Load("https://localhost/Discoverydoc.disco");

XmlNode myXmlRoot = myXmlDocument.get_FirstChild();
XmlNode myXmlNode = myXmlRoot.get_Item("scl:contractRef");
XmlAttributeCollection myAttributeCollection = myXmlNode.
    get_Attributes();
myContractReference.set_Ref(myAttributeCollection.Item(0).get_Value());
Console.WriteLine("The URL to the referenced service "
    + "description is : {0}", myContractReference.get_Ref());
myContractReference.set_DocRef(myAttributeCollection.Item(1).
    get_Value());
Console.WriteLine("The URL implementing the referenced service "
    + "description is : {0}", myContractReference.get_DocRef());

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ContractReference-Klasse
ContractReference-Member
System.Web.Services.Discovery-Namespace
Ref