WebServiceAttribute.Namespace Eigenschap

Definitie

Hiermee haalt u de standaard-XML-naamruimte op die moet worden gebruikt voor de XML-webservice.

public:
 property System::String ^ Namespace { System::String ^ get(); void set(System::String ^ value); };
public string Namespace { get; set; }
member this.Namespace : string with get, set
Public Property Namespace As String

Waarde van eigenschap

De standaard-XML-naamruimte die moet worden gebruikt voor de XML-webservice. De standaardwaarde wordt opgegeven in de DefaultNamespace eigenschap.

Voorbeelden

In het volgende voorbeeld wordt die naamruimte voor de Action eigenschap ingesteld Namespacehttp://www.contoso.com en overschreven door een SoapDocumentMethodAttribute toe te voegen aan de Time XML-webservicemethode.

<%@ WebService Language="C#" class= "ServerVariables"%>
 
 using System;
 using System.Web.Services;
 using System.Web.Services.Protocols;
 
 [ WebService(Description="Server Variables",
 Namespace="http://www.contoso.com/")]
 public class ServerVariables: WebService {
    [ SoapDocumentMethod(Action="http://www.contoso.com/Time")]
    [ WebMethod(Description="Returns the time as stored on the Server",EnableSession=false)]
    public string Time() {
       return Context.Timestamp.TimeOfDay.ToString();
    }
 }
<%@ WebService Language="VB" class= "ServerVariables"%>
 
Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols

<WebService(Description := "Server Variables", _
    Namespace := "http://www.contoso.com/")> _
Public Class ServerVariables
    Inherits WebService

    <SoapDocumentMethod(Action := "http://www.contoso.com/Time"), _
        WebMethod(Description := "Returns the time as stored on the Server", _
        EnableSession := False)> _
    Public Function Time() As String
        
        Return Context.Timestamp.TimeOfDay.ToString()
    End Function
End Class

Opmerkingen

XML-naamruimten bieden een manier om namen te maken in een XML-document dat wordt geïdentificeerd door een URI (Uniform Resource Identifier). Met behulp van XML-naamruimten kunt u elementen of kenmerken in een XML-document uniek identificeren. De servicebeschrijving voor een XML-webservice wordt gedefinieerd in XML, met name in WSDL (Web Services Description Language).

Binnen de servicebeschrijving voor een XML-webservice wordt Namespace deze gebruikt als de standaardnaamruimte voor XML-elementen die rechtstreeks betrekking hebben op de XML-webservice. De naam van de XML-webservice en de bijbehorende XML-webservicemethoden hebben bijvoorbeeld betrekking op de naamruimte die is opgegeven in de Namespace eigenschap. Elementen die specifiek zijn voor WSDL, hebben betrekking op de http://schemas.xmlsoap.org/wsdl/ naamruimte.

Voor XML-webserviceclients die SOAP gebruiken om een XML-webservice aan te roepen, kunt u desgewenst een SoapDocumentMethodAttribute XML-webservicemethode toevoegen of SoapRpcMethodAttribute aanroepen. Als de client een XML-webservice aanroept die is gemaakt met ASP.NET, worden de eigenschappen RequestNamespace, ResponseNamespace en Action standaard afgeleid van de eigenschap Namespace. Op basis van Time een XML-webservicemethodenaam en een Namespace eigenschap vanhttp://www.contoso.com/, is http://www.contoso.com/Time de Action eigenschap standaard. Als u de standaardinstellingen voor RequestNamespace, ResponseNamespaceen Action voor een XML-webservicemethode wilt wijzigen, kunt u een methode SoapDocumentMethodAttribute toevoegen aan de XML-webservicemethode.

Note

Een XML-naamruimte verschilt van de naamruimte waarin de klasse zich bevindt, in termen van de Windows SDK. Zie Naamruimtetrefwoorden als u in C# schrijft om de naamruimte voor de klasse op te geven.

Van toepassing op

Zie ook