WebReference Klasse

Definition

Namespace:

System.Web.Services.Description

Assembly:

System.Web.Services.dll

Beschreibt einen Verweis auf eine Auflistung von XML-Webdiensten.

public ref class WebReference sealed

public sealed class WebReference

type WebReference = class

Public NotInheritable Class WebReference

Vererbung

Object

WebReference

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Klasse veranschaulicht.

using System;
using System.CodeDom;
using System.CodeDom.Compiler;
using System.Security.Permissions;
using System.Web.Services;
using System.Web.Services.Description;
using System.Web.Services.Discovery;
using System.Xml;
using System.Xml.Serialization;

class Test
{

    [SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted=true)]
    static void Run(){

   // Get a WSDL file describing a service.
        ServiceDescription description = ServiceDescription.Read("DataTypes_CS.wsdl");

    // Initialize a service description importer.
    ServiceDescriptionImporter importer = new ServiceDescriptionImporter();
    importer.ProtocolName = "Soap12";  // Use SOAP 1.2.
    importer.AddServiceDescription(description,null,null);

    // Report on the service descriptions.
    Console.WriteLine("Importing {0} service descriptions with {1} associated schemas.",
                      importer.ServiceDescriptions.Count, importer.Schemas.Count);

    // Generate a proxy client.
    importer.Style = ServiceDescriptionImportStyle.Client;

    // Generate properties to represent primitive values.
    importer.CodeGenerationOptions = System.Xml.Serialization.CodeGenerationOptions.GenerateProperties;

    // Initialize a Code-DOM tree into which we will import the service.
    CodeNamespace nmspace = new CodeNamespace();
    CodeCompileUnit unit1 = new CodeCompileUnit();
    unit1.Namespaces.Add(nmspace);

    // Import the service into the Code-DOM tree. This creates proxy code
    // that uses the service.
    ServiceDescriptionImportWarnings warning = importer.Import(nmspace, unit1);

    if (warning == 0)
    {
        // Generate and print the proxy code in C#.
        CodeDomProvider provider1 = CodeDomProvider.CreateProvider("CSharp");
        provider1.GenerateCodeFromCompileUnit(unit1, Console.Out, new CodeGeneratorOptions());
    }
    else
    {
        // Print an error message.
        Console.WriteLine("Warning: " + warning); 
    }

        string url = "AddNumbers.wsdl";

        // Read in a WSDL service description.
        XmlTextReader reader = new XmlTextReader(url);
        ServiceDescription wsdl = ServiceDescription.Read(reader);

        // Create a WSDL collection.
        DiscoveryClientDocumentCollection wsdlCollection = new DiscoveryClientDocumentCollection();
        wsdlCollection.Add(url, wsdl);

        // Create a namespace and a unit for compilation.
        CodeNamespace space = new CodeNamespace();
        CodeCompileUnit unit = new CodeCompileUnit();
        unit.Namespaces.Add(space);

        // Create a web referernce using the WSDL collection.
        WebReference reference = new WebReference(wsdlCollection, space);
        reference.ProtocolName = "Soap12";

        // Print some information about the web reference.
        Console.WriteLine("Base Url = {0}", reference.AppSettingBaseUrl);
        Console.WriteLine("Url Key = {0}", reference.AppSettingUrlKey);
        Console.WriteLine("Documents = {0}", reference.Documents.Count);

        // Create a web reference collection.
        WebReferenceCollection references = new WebReferenceCollection();
        references.Add(reference);

        // Compile a proxy client and print out the code. 
        CodeDomProvider provider = CodeDomProvider.CreateProvider("CSharp");
        WebReferenceOptions options = new WebReferenceOptions();
        options.Style = ServiceDescriptionImportStyle.Client;
        options.CodeGenerationOptions = CodeGenerationOptions.GenerateNewAsync;
        ServiceDescriptionImporter.GenerateWebReferences(
            references,
            provider,
            unit,
            options        
        );
        provider.GenerateCodeFromCompileUnit(unit, Console.Out, new CodeGeneratorOptions() );          
    }

    static void Main ()
    {

        Test.Run();
    }
}

Hinweise

Ein WebReference -Objekt wird verwendet, um Informationen zu einer Reihe von Webdiensten an die statische GenerateWebReferences Methode der ServiceDescriptionImporter -Klasse zu übergeben.

Konstruktoren

WebReference(DiscoveryClientDocumentCollection, CodeNamespace)	Initialisiert eine neue Instanz der WebReference-Klasse mit der angegebenen Beschreibungsdokumentauflistung und dem angegebenen Proxycodenamespace.
WebReference(DiscoveryClientDocumentCollection, CodeNamespace, String, String)	Initialisiert eine neue Instanz der WebReference-Klasse mit den angegebenen Daten.
WebReference(DiscoveryClientDocumentCollection, CodeNamespace, String, String, String)	Initialisiert eine neue Instanz der WebReference-Klasse mit den angegebenen Daten.

Eigenschaften

AppSettingBaseUrl	Ruft die Basis-URL des Webverweises ab.
AppSettingUrlKey	Ruft den URL-Schlüssel des Webverweises ab.
Documents	Ruft die Auflistung der diesem Webverweis zugeordneten Beschreibungsdokumente ab.
ProtocolName	Ruft das dem Webverweis zugeordnete Protokoll ab oder legt dieses fest.
ProxyCode	Ruft den dem Webverweis zugeordneten Codenamespace ab.
ValidationWarnings	Ruft eine Auflistung der beim Validieren der Beschreibungsdokumente generierten Warnungen ab.
Warnings	Ruft eine Auflistung der beim Importieren von WSDL-Dienstbeschreibungsdokumenten (Web Services Description Language) generierten Warnungen ab.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)