WebServiceAttribute.Namespace-Eigenschaft

Ruft den XML-Standardnamespace für den XML-Webdienst ab oder legt ihn fest.

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

Syntax

'Declaration
Public Property Namespace As String
'Usage
Dim instance As WebServiceAttribute
Dim value As String

value = instance.Namespace

instance.Namespace = value

public string Namespace { get; set; }

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

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

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

public function get Namespace () : String

public function set Namespace (value : String)

Eigenschaftenwert

Der XML-Standardnamespace für den XML-Webdienst. Der Standardwert wird in der DefaultNamespace-Eigenschaft angegeben.

Hinweise

Mit XML-Namespaces können Namen in einem XML-Dokument erstellt werden, die durch einen URI (Uniform Resource Identifier) bezeichnet werden. Durch die Verwendung von XML-Namespaces können Sie Elemente und Attribute in einem XML-Dokument eindeutig bezeichnen. Die Dienstbeschreibung für einen XML-Webdienst wird in XML (in WSDL [Web Service Description Language]) definiert.

In der Dienstbeschreibung für einen XML-Webdienst wird Namespace als Standardnamespace für XML-Elemente verwendet, die sich direkt auf den XML-Webdienst beziehen. Der Name des XML-Webdiensts und die zugehörigen XML-Webdienstmethoden beziehen sich z. B. auf den Namespace, der in der Namespace-Eigenschaft angegeben ist. WSDL-spezifische Elemente beziehen sich auf den Namespace https://schemas.xmlsoap.org/wsdl/

Damit XML-Webdienstclients SOAP verwenden, um einen XML-Webdienst aufzurufen, können Sie das SoapDocumentMethodAttribute oder das SoapRpcMethodAttribute hinzufügen, um eine XML-Webdienstmethode aufzurufen. Beim Aufrufen eines mit ASP.NET erstellten XML-Webdiensts durch den Client werden die Eigenschaften RequestNamespace, ResponseNamespace und Action in der Standardeinstellung von der Namespace-Eigenschaft abgeleitet. Wenn der Name einer XML-Webdienstmethode beispielsweise Time lautet und die Namespace-Eigenschaft https://www.contoso.com/ ist, ist die Action-Eigenschaft in der Standardeinstellung https://www.contoso.com/time. Wenn Sie die Standardeinstellungen für RequestNamespace, ResponseNamespace und Action für eine XML-Webdienstmethode ändern möchten, können Sie der XML-Webdienstmethode ein SoapDocumentMethodAttribute hinzufügen.

Beispiel

Im folgenden Beispiel wird Namespace auf https://www.contoso.com festgelegt und dieser Namespace für die Action-Eigenschaft überschrieben, indem der Time-XML-Webdienstmethode ein SoapDocumentMethodAttribute hinzugefügt wird.

<%@ WebService Language="VB" class= "ServerVariables"%>
 
Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols

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

    <SoapDocumentMethod(Action := "https://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

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

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

WebServiceAttribute-Klasse
WebServiceAttribute-Member
System.Web.Services-Namespace
DefaultNamespace
SoapDocumentMethodAttribute
RequestNamespace
ResponseNamespace
Action
SoapRpcMethodAttribute