WebServiceAttribute-Klasse

Artikel
08/20/2007

Wird zum Hinzufügen zusätzlicher Informationen zu einem XML-Webdienst verwendet, z. B. beim Hinzufügen einer Zeichenfolge, die die Funktionalität des XML-Webdiensts beschreibt.

Namespace: System.Web.Services
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Interface)> _
Public NotInheritable Class WebServiceAttribute
    Inherits Attribute
'Usage
Dim instance As WebServiceAttribute

[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Interface)] 
public sealed class WebServiceAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Interface)] 
public ref class WebServiceAttribute sealed : public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Interface) */ 
public final class WebServiceAttribute extends Attribute

AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Interface) 
public final class WebServiceAttribute extends Attribute

Hinweise

Das WebServiceAttribute ist für das Veröffentlichen und Ausführen eines XML-Webdiensts nicht erforderlich. Sie können das WebServiceAttribute verwenden, um einen Namen für den XML-Webdienst anzugeben, der keinen Einschränkungen durch die Regeln für einen Common Language Runtime-Bezeichner unterliegt. Dieser wird in der Dienstbeschreibung und auf der Hilfeseite Dienst für den XML-Webdienst verwendet.

Vor der Veröffentlichung muss ein XML-Webdienst seinen XML-Standardnamespace ändern. Jeder XML-Webdienst benötigt zur Identifizierung einen eindeutigen XML-Namespace, sodass Clientanwendungen ihn von anderen Diensten im Web unterscheiden können. Für XML-Webdienste in der Entwicklungsphase steht http://tempuri.org/ zur Verfügung, veröffentlichte XML-Webdienste müssen jedoch einen dauerhafteren Namespace verwenden.

Der XML-Webdienst muss durch einen von Ihnen gesteuerten XML-Namespace identifiziert werden. Sie können z. B. den Internetdomänennamen des Unternehmens im XML-Namespace verwenden. Obwohl die XML-Namespaces vieler XML-Webdienste wie URLs aussehen, müssen sie nicht tatsächlich auf eine Ressource im Web verweisen. (XML-Namespaces für XML-Webdienste sind URIs.) Bei mit ASP.NET erstellten XML-Webdiensten kann der XML-Standardnamespace mithilfe der Namespace-Eigenschaft geändert werden.

Weitere Informationen zum Verwenden von Attributen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

Beispiel

Im folgenden Beispiel werden die Description-Eigenschaft des WebServiceAttribute auf "Common Server Variables" und der XML-Namespace auf https://www.microsoft.com/germany. festgelegt.

<%@ WebService Language="VB" Class= "ServerVariables"%>
 
Imports System
Imports System.Web.Services

<WebService(Description := "Common Server Variables", _
 Namespace := "https://www.contoso.com/")> _
Public Class ServerVariables
    Inherits WebService 
    
    <WebMethod(Description := "Obtains the Computer Machine Name", _
        EnableSession := False)> _
    Public Function GetMachineName() As String
        
        Return Server.MachineName
    End Function
End Class

<%@ WebService Language="C#" Class= "ServerVariables"%>
 
 using System;
 using System.Web.Services;
 
 [ WebService(Description="Common Server Variables",Namespace="https://www.contoso.com/")]
 public class ServerVariables: WebService {
 
 
    [ WebMethod(Description="Obtains the Server Computer Name",EnableSession=false)]
    public string GetMachineName() {
       return Server.MachineName;
    }   
 }

Vererbungshierarchie

System.Object
System.Attribute
System.Web.Services.WebServiceAttribute

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebServiceAttribute-Member
System.Web.Services-Namespace
WebService-Klasse
WebMethodAttribute-Klasse
SoapDocumentMethodAttribute
SoapDocumentServiceAttribute
SoapRpcMethodAttribute
SoapRpcServiceAttribute

Freigeben über