Język

WebServiceAttribute.Name Właściwość

Definicja

Pobiera lub ustawia nazwę usługi sieci Web XML.

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

Wartość właściwości

Nazwa usługi sieci Web XML. Wartość domyślna to nazwa klasy implementowania usługi sieci Web XML.

Przykłady

Poniższe przykładowe zestawy Name usługi sieci Web XML na 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

Uwagi

Opis usługi jest generowany, gdy użytkownik przechodzi do adresu URL usługi sieci Web XML i dostarcza ciąg zapytania o wartości ? WSDL. W opisie usługi Name właściwość identyfikuje lokalną część kwalifikowanej nazwy XML dla usługi sieci Web XML. Właściwość Name jest również używana do wyświetlania nazwy usługi sieci Web XML na stronie pomocy usługi. Strona pomocy usługi jest wyświetlana, gdy potencjalny konsument przechodzi do strony asmx dla usługi sieci Web XML bez określania nazwy metody usługi sieci Web XML i jej parametrów.

Kwalifikowana nazwa XML służy do uściślania elementów o tej samej nazwie z dokumentem XML. Kwalifikowana nazwa XML składa się z dwóch następujących części oddzielonych dwukropkiem: przestrzeni nazw lub prefiksu skojarzonego z przestrzenią nazw i częścią lokalną. Przestrzeń nazw składa się z odwołania do identyfikatora URI, a na potrzeby opisu usługi jest wartością Namespace właściwości . Ogólnie rzecz biorąc, prefiks, który działa jak alias identyfikatora URI, jest skojarzony z przestrzenią nazw, dzięki czemu wszystkie kolejne nazwy kwalifikowane XML używające przestrzeni nazw mogą używać skróconego prefiksu. Część lokalna jest ciągiem rozpoczynającym się od litery lub podkreślenia bez spacji. W związku z tym kwalifikowana nazwa XML identyfikująca usługę sieci Web XML w opisie usługi ma następujący format:

Namespace : Name

Aby uzyskać więcej informacji na temat kwalifikowanych nazw XML, zobacz Przestrzenie nazw w formacie XML 1.0.

Dotyczy

Zobacz też