WebServiceAttribute.Name Eigenschaft

Definition

Namespace:

System.Web.Services

Assembly:

System.Web.Services.dll

Ruft den Namen des XML-Webdiensts ab oder legt ihn fest.

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

public string Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

Eigenschaftswert

String

Der Name des XML-Webdiensts. Standardwert ist der Name der Klasse, die den XML-Webdienst implementiert.

Beispiele

Im folgenden Beispiel wird der XML-Webdienst auf MyNamefestgelegtName.

<%@ WebService Language="C#" class= "ServerVariables"%>
 
 using System.Web.Services;
 
 [ WebService(Description="Server Variables",
              Namespace="http://www.microsoft.com/",
              Name="MyName")]
 public class ServerVariables: WebService {
    [ 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.Web.Services

<WebService(Description := "Server Variables", _
    Namespace := "http://www.microsoft.com/", _
    Name := "MyName")> _
Public Class ServerVariables
    Inherits WebService
    
    <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

Die Dienstbeschreibung wird generiert, wenn ein Benutzer zur URL für den XML-Webdienst navigiert und eine Abfragezeichenfolge von bereitstellt. WSDL. Innerhalb der Dienstbeschreibung identifiziert die Name -Eigenschaft den lokalen Teil des XML-qualifizierten Namens für den XML-Webdienst. Die Name -Eigenschaft wird auch verwendet, um den Namen des XML-Webdiensts auf der Hilfeseite des Diensts anzuzeigen. Die Hilfeseite des Diensts wird angezeigt, wenn ein potenzieller Consumer zur Seite .asmx für den XML-Webdienst navigiert, ohne einen XML-Webdienstmethodennamen und die zugehörigen Parameter anzugeben.

Ein xml-qualifizierter Name wird verwendet, um Elemente mit demselben Namen mit einem XML-Dokument zu trennen. Ein durch XML qualifizierter Name besteht aus den folgenden zwei Teilen, die durch einen Doppelpunkt getrennt sind: namespace oder ein Präfix, das einem Namespace und einem lokalen Teil zugeordnet ist. Der Namespace besteht aus einem URI-Verweis und ist für die Zwecke der Dienstbeschreibung der Wert der Namespace -Eigenschaft. Im Allgemeinen wird ein Präfix, das wie ein Alias für einen URI fungiert, dem Namespace zugeordnet, sodass alle nachfolgenden xml-qualifizierten Namen, die den Namespace verwenden, das verkürzte Präfix verwenden können. Der lokale Teil ist eine Zeichenfolge, die mit einem Buchstaben oder Unterstrich beginnt, der keine Leerzeichen enthält. Daher hat der XML-qualifizierte Name, der einen XML-Webdienst in der Dienstbeschreibung identifiziert, das folgende Format:

Namespace : Name

Weitere Informationen zu XML-qualifizierten Namen finden Sie unter Namespaces in XML 1.0.

Weitere Informationen

• Namespace