WebServiceAttribute.Namespace Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví výchozí obor názvů XML použít pro webovou službu 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
Hodnota vlastnosti
Výchozí obor názvů XML, který se má použít pro webovou službu XML. Ve vlastnosti je zadána DefaultNamespace výchozí hodnota.
Příklady
Následující příklad nastaví Namespacehttp://www.contoso.com a přepíše obor názvů pro Action vlastnost přidáním SoapDocumentMethodAttribute do Time metody webové služby 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
Poznámky
Obory názvů XML nabízejí způsob, jak vytvořit názvy v dokumentu XML, které jsou identifikované identifikátorem URI (Uniform Resource Identifier). Pomocí oborů názvů XML můžete jedinečně identifikovat elementy nebo atributy v dokumentu XML. Popis služby pro webovou službu XML je definován v jazyce XML, konkrétně v jazyce WSDL (Web Services Description Language).
V rámci popisu služby pro webovou službu Namespace XML se používá jako výchozí obor názvů pro elementy XML přímo související s webovou službou XML. Například název webové služby XML a jeho metody webové služby XML se týkají oboru názvů zadaného Namespace ve vlastnosti. Elementy specifické pro WSDL se týkají http://schemas.xmlsoap.org/wsdl/ oboru názvů.
Pro klienty webové služby XML využívající protokol SOAP k volání webové služby XML můžete volitelně přidat SoapDocumentMethodAttribute nebo SoapRpcMethodAttribute volat metodu webové služby XML. Pokud klient volá webovou službu XML vytvořenou pomocí ASP.NET, RequestNamespaceResponseNamespace všechny vlastnosti a Action vlastnosti jsou odvozeny z Namespace vlastnosti ve výchozím nastavení. Například vzhledem k názvu Time metody webové služby XML a Namespace vlastnosti http://www.contoso.com/, Action vlastnost je http://www.contoso.com/Time ve výchozím nastavení. Chcete-li změnit výchozí nastavení pro RequestNamespace, ResponseNamespacea Action pro metodu webové služby XML, můžete přidat SoapDocumentMethodAttribute do metody webové služby XML.
Poznámka:
Obor názvů XML se liší od oboru názvů, ve kterém se třída nachází, pokud jde o sadu Windows SDK. Pokud chcete zadat obor názvů pro třídu, přečtěte si téma Klíčová slova oboru názvů , pokud píšete v jazyce C#.