WebServiceAttribute.Namespace Eigenschaft

Definition

Namespace:

System.Web.Services

Assembly:

System.Web.Services.dll

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

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

Eigenschaftswert

String

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

Beispiele

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

<%@ 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

Hinweise

XML-Namespaces bieten eine Möglichkeit, Namen in einem XML-Dokument zu erstellen, die durch einen URI (Uniform Resource Identifier) identifiziert werden. Mithilfe von XML-Namespaces können Sie Elemente oder Attribute in einem XML-Dokument eindeutig identifizieren. Die Dienstbeschreibung für einen XML-Webdienst ist in XML definiert, insbesondere in Web Services Description Language (WSDL).

Innerhalb der Dienstbeschreibung für einen XML-Webdienst wird als Standardnamespace für XML-Elemente verwendet, Namespace die sich direkt auf den XML-Webdienst beziehen. Beispielsweise beziehen sich der Name des XML-Webdiensts und seine XML-Webdienstmethoden auf den in der Namespace -Eigenschaft angegebenen Namespace. Elemente, die für WSDL spezifisch sind, beziehen sich auf den http://schemas.xmlsoap.org/wsdl/ Namespace.

Für XML-Webdienstclients, die SOAP zum Aufrufen eines XML-Webdiensts verwenden, können Sie optional die SoapDocumentMethodAttribute -Methode oder SoapRpcMethodAttribute hinzufügen, um eine XML-Webdienstmethode aufzurufen. Wenn der Client einen xml-Webdienst aufruft, der mit ASP.NET erstellt wurde, werden die RequestNamespaceEigenschaften und ResponseNamespaceAction standardmäßig von der Namespace -Eigenschaft abgeleitet. Bei instance lautet die -Eigenschaft standardmäßig, wenn ein XML-Webdienstmethodenname von Time und eine Namespace Eigenschaft von http://www.contoso.com/angegeben wirdhttp://www.contoso.com/Time.Action Um die Standardeinstellungen für RequestNamespace, ResponseNamespaceund Action für eine XML-Webdienstmethode zu ändern, können Sie der XML-Webdienstmethode eine SoapDocumentMethodAttribute hinzufügen.

Hinweis

Ein XML-Namespace unterscheidet sich vom Namespace, in dem sich die Klasse befindet, in Bezug auf das Windows SDK. Informationen zum Angeben des Namespace für die Klasse finden Sie unter Namespaceschlüsselwörter , wenn Sie in C# schreiben.

Weitere Informationen

• DefaultNamespace
• SoapDocumentMethodAttribute
• RequestNamespace
• ResponseNamespace
• Action
• SoapRpcMethodAttribute