WebServiceAttribute.Namespace Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.