Freigeben über


WebServiceAttribute.Name Eigenschaft

Definition

Dient zum Abrufen oder Festlegen des Namens des XML-Webdiensts.

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

Der Name für den XML-Webdienst. Der Standardwert ist der Name der Klasse, die den XML-Webdienst implementiert.

Beispiele

Im folgenden Beispiel wird Name der XML-Webdienst auf MyName.

<%@ 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 ? 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 ASMX-Seite für den XML-Webdienst navigiert, ohne einen Namen der XML-Webdienstmethode und dessen Parameter anzugeben.

Ein XML-qualifizierter Name wird verwendet, um Mehrdeutigkeiten von Elementen mit demselben Namen mit einem XML-Dokument zu unterscheiden. Ein qualifizierter XML-Name besteht aus den folgenden beiden 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 für die Zwecke der Dienstbeschreibung ist 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 mit dem Namespace das gekü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 weist der XML-qualifizierte Name, der einen XML-Webdienst in der Dienstbeschreibung identifiziert, im folgenden Format auf:

Namespace : Name

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

Gilt für:

Weitere Informationen