Export (0) Print
Expand All

Import Class

Associates an XML namespace with a document location. This class cannot be inherited.

For a list of all members of this type, see Import Members.

System.Object
   System.Web.Services.Description.DocumentableItem
      System.Web.Services.Description.Import

[Visual Basic]
NotInheritable Public Class Import
   Inherits DocumentableItem
[C#]
public sealed class Import : DocumentableItem
[C++]
public __gc __sealed class Import : public DocumentableItem
[JScript]
public class Import extends DocumentableItem

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Remarks

The Web Services Description Language (WSDL) <import> element that is enclosed by the <definitions> element allows the separation of different parts of the XML Web service into different documents, which can then be imported as needed. Each document's URL is associated with a unique XML tag prefix representing the XML namespace for that document's elements. For more information about WSDL, see the specification at http://www.w3.org/TR/wsdl/. For more information about XML namespaces, see the Namespace property.

Example

[Visual Basic, C#, C++] The following example shows a user-defined method that creates a new instance of the Import class.

[Visual Basic] 
Imports System
Imports System.Web.Services.Description
Imports System.Collections
Imports System.Xml

Class MySample
   Public Shared Sub Main()
      Console.WriteLine("Import Sample")
      
      Dim myServiceDescription As ServiceDescription = _
         ServiceDescription.Read("StockQuote_vb.wsdl")
      myServiceDescription.Imports.Add( _
         CreateImport("http://localhost/stockquote/schemas", _
         "http://localhost/stockquote/stockquote_vb.xsd"))
      ' Save the ServiceDescripition to an external file.
      myServiceDescription.Write("StockQuote_vb.wsdl")
      Console.WriteLine("Successfully added Import to WSDL document " _
         & "'StockQuote_vb.wsdl'")
      ' Print the import collection to the console.
      PrintImportCollection("StockQuote_vb.wsdl")
        myServiceDescription = _
           ServiceDescription.Read("StockQuoteService_vb.wsdl")
      myServiceDescription.Imports.Insert(0, _
         CreateImport("http://localhost/stockquote/definitions", _
         "http://localhost/stockquote/stockquote_vb.wsdl"))
      ' Save the ServiceDescripition to an external file.
      myServiceDescription.Write("StockQuoteService_vb.wsdl")
      Console.WriteLine("")
      Console.WriteLine("Successfully added Import to " & _
         "WSDL document 'StockQuoteService_vb.wsdl'")
      'Print the import collection to the console.
      PrintImportCollection("StockQuoteService_vb.wsdl")
   End Sub 'Main

   ' Creates an Import object with namespace and location.
   Public Shared Function CreateImport(targetNamespace As String, _
      targetlocation As String) As Import
      Dim myImport As New Import()
      myImport.Location = targetlocation
      myImport.Namespace = targetNamespace
      Return myImport
   End Function 'CreateImport

   Public Shared Sub PrintImportCollection(fileName_wsdl As String)

      ' Read import collection properties from generated WSDL file.
      Dim myServiceDescription1 As _
         ServiceDescription = ServiceDescription.Read(fileName_wsdl)
      Dim myImportCollection As ImportCollection = myServiceDescription1.Imports
      Console.WriteLine("Enumerating Import Collection for file '" & _
         fileName_wsdl & "'...")

      ' Print Import properties to the console.
      Dim i As Integer
      For i = 0 To myImportCollection.Count - 1
         Console.WriteLine("Namespace : " & myImportCollection(i).Namespace)
         Console.WriteLine("Location  : " & myImportCollection(i).Location)
         Console.WriteLine("ServiceDescription  : " & _
            myImportCollection(i).ServiceDescription.Name)
      Next i
   End Sub 'PrintImportCollection
End Class 'MySample

[C#] 
using System;
using System.Web.Services.Description;
using System.Collections;
using System.Xml;

class MySample
{
   public static void Main()
   {
      Console.WriteLine("Import Sample");
      ServiceDescription myServiceDescription = 
         ServiceDescription.Read("StockQuote_cs.wsdl");
      myServiceDescription.Imports.Add(
         CreateImport("http://localhost/stockquote/schemas",
         "http://localhost/stockquote/stockquote_cs.xsd"));
      // Save the ServiceDescripition to an external file.
      myServiceDescription.Write("StockQuote_cs.wsdl");
      Console.WriteLine(
         "Successfully added import to WSDL document 'StockQuote_cs.wsdl'");

      // Print the import collection to the console.
      PrintImportCollection("StockQuote_cs.wsdl");
      myServiceDescription = 
         ServiceDescription.Read("StockQuoteService_cs.wsdl");
      myServiceDescription.Imports.Insert(
         0,CreateImport("http://localhost/stockquote/definitions",
         "http://localhost/stockquote/stockquote_cs.wsdl"));
      // Save the ServiceDescripition to an external file.
      myServiceDescription.Write("StockQuoteService_cs.wsdl");
      Console.WriteLine("");
      Console.WriteLine("Successfully added import to WSDL " +
         "document 'StockQuoteService_cs.wsdl'");

      //Print the import collection to the console.
      PrintImportCollection("StockQuoteService_cs.wsdl");
   }
   // Creates an Import object with namespace and location.
   public static Import CreateImport(string targetNamespace, 
      string targetlocation)
   {
      Import myImport = new Import();
      myImport.Location = targetlocation;
      myImport.Namespace = targetNamespace;
      return myImport;
   }

   public static void PrintImportCollection(string fileName_wsdl)
   {
      // Read import collection properties from generated WSDL file.
      ServiceDescription myServiceDescription1 = 
         ServiceDescription.Read(fileName_wsdl);
      ImportCollection myImportCollection = myServiceDescription1.Imports;
      Console.WriteLine("Enumerating Import Collection for file '" + 
         fileName_wsdl +"'...");

      // Print Import properties to console.
      for(int i =0; i < myImportCollection.Count; ++i)
      {
         Console.WriteLine("Namespace : " + myImportCollection[i].Namespace);
         Console.WriteLine("Location  : " + myImportCollection[i].Location);
         Console.WriteLine("ServiceDescription  : " + 
            myImportCollection[i].ServiceDescription.Name);
      }
   }
}

[C++] 
#using <mscorlib.dll>
#using <System.dll>
#using <System.Xml.dll>
#using <System.Web.Services.dll>
using namespace System;
using namespace System::Web::Services::Description;
using namespace System::Collections;
using namespace System::Xml;

// Creates an Import object with namespace and location.
Import * CreateImport(String* targetNamespace, String* targetlocation) 
{
   Import* myImport = new Import();
   myImport->Location = targetlocation;
   myImport->Namespace = targetNamespace;
   return myImport;
}


void PrintImportCollection(String* fileName_wsdl)
{
   // Read import collection properties from generated WSDL file.
   ServiceDescription * myServiceDescription1 = 
      ServiceDescription::Read(fileName_wsdl);
   ImportCollection * myImportCollection = myServiceDescription1->Imports;
   Console::WriteLine(S"Enumerating Import Collection for file ' {0}'...",
      fileName_wsdl);

   // Print Import properties to console.
   for (int i =0; i < myImportCollection->Count; ++i) 
   {
      Console::WriteLine(S"Namespace : {0}", 
         myImportCollection->Item[i] -> Namespace);
      Console::WriteLine(S"Location  : {0}", 
         myImportCollection->Item[i] -> Location);
      Console::WriteLine(S"ServiceDescription  : {0}", 
         myImportCollection->Item[i]->ServiceDescription->Name);
   }
}

int main()
{
   Console::WriteLine(S"Import Sample");
   ServiceDescription * myServiceDescription = 
      ServiceDescription::Read(S"StockQuote_cpp.wsdl");
   myServiceDescription->Imports->Add(
      CreateImport(S"http://localhost/stockquote/schemas", 
      S"http://localhost/stockquote/stockquote_cpp.xsd"));
   // Save the ServiceDescripition to an external file.
   myServiceDescription->Write(S"StockQuote_cpp.wsdl");
   Console::WriteLine(S"Successfully added Import to WSDL "\
       S"document 'StockQuote_cpp.wsdl'");

   // Print the import collection to the console.
   PrintImportCollection(S"StockQuote_cpp.wsdl");
   myServiceDescription = 
      ServiceDescription::Read(S"StockQuoteService_cpp.wsdl");
   myServiceDescription->Imports->Insert(0, 
      CreateImport(S"http://localhost/stockquote/definitions", 
      S"http://localhost/stockquote/stockquote_cpp.wsdl"));
   // Save the ServiceDescripition to an external file.
   myServiceDescription->Write(S"StockQuoteService_cs::wsdl");
   Console::WriteLine(S"");
   Console::WriteLine(S"Successfully added Import to WSDL "\
      S"document 'StockQuoteService_cpp.wsdl'");

   //Print the import collection to the console.
   PrintImportCollection(S"StockQuoteService_cpp.wsdl");
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Namespace: System.Web.Services.Description

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: System.Web.Services (in System.Web.Services.dll)

See Also

Import Members | System.Web.Services.Description Namespace

Show:
© 2014 Microsoft