WebServiceAttribute.Name Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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:
Weitere Informationen zu XML-qualifizierten Namen finden Sie unter Namespaces in XML 1.0.