WebServiceAttribute.Namespace Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.Services
Zestaw:
System.Web.Services.dll

Pobiera lub ustawia domyślną przestrzeń nazw XML do użycia dla usługi sieci Web XML.

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

Wartość właściwości

String

Domyślna przestrzeń nazw XML używana dla usługi sieci Web XML. Wartość domyślna jest określona DefaultNamespace we właściwości .

Przykłady

Poniższy przykład ustawia wartość Namespacehttp://www.contoso.com i zastępuje tę przestrzeń nazw dla Action właściwości, dodając element SoapDocumentMethodAttribute do Time metody usługi sieci Web XML.

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

Uwagi

Przestrzenie nazw XML oferują sposób tworzenia nazw w dokumencie XML identyfikowanym przez identyfikator URI (Uniform Resource Identifier). Za pomocą przestrzeni nazw XML można jednoznacznie identyfikować elementy lub atrybuty w dokumencie XML. Opis usługi sieci Web XML jest zdefiniowany w formacie XML, w szczególności w języku WSDL (Web Services Description Language).

W opisie usługi dla usługi Namespace sieci Web XML jest używana jako domyślna przestrzeń nazw dla elementów XML bezpośrednio odnoszących się do usługi sieci Web XML. Na przykład nazwa usługi sieci Web XML i jej metody usługi sieci Web XML odnoszą się do przestrzeni nazw określonej we Namespace właściwości. Elementy specyficzne dla języka WSDL odnoszą się do http://schemas.xmlsoap.org/wsdl/ przestrzeni nazw.

W przypadku klientów usługi sieci Web XML używających protokołu SOAP do wywoływania usługi sieci Web XML można opcjonalnie dodać SoapDocumentMethodAttribute metodę lub SoapRpcMethodAttribute wywołać metodę usługi sieci Web XML. Jeśli klient wywołuje usługę sieci Web XML utworzoną przy użyciu ASP.NET, RequestNamespaceResponseNamespace właściwości i Action są domyślnie uzyskiwane z Namespace właściwości . Na przykład, biorąc pod uwagę nazwę Time metody usługi sieci Web XML i Namespace właściwość http://www.contoso.com/, Action właściwość jest http://www.contoso.com/Time domyślnie. Aby zmienić ustawienia domyślne dla RequestNamespacemetody , ResponseNamespacei Action dla metody usługi sieci Web XML, możesz dodać element SoapDocumentMethodAttribute do metody usługi sieci Web XML.

Uwaga

Przestrzeń nazw XML różni się od przestrzeni nazw, w których znajduje się klasa, w odniesieniu do zestawu Windows SDK. Aby określić przestrzeń nazw dla klasy, zobacz Słowa kluczowe przestrzeni nazw , jeśli piszesz w języku C#.

Dotyczy

Zobacz też