Sdílet prostřednictvím

VSProject2.AddWebReference – metoda (String)

  • Článek

Přidá odkaz na webovou službu k projektu. Novou podsložku referenční webové služby je přidána do složky odkazů na projektu. Tato nová složka obsahuje několik položek projektu související webové služby. Metoda vrátí ProjectItem objekt přidružený k nové složce webové služby.

Obor názvů:  VSLangProj80
Sestavení:  VSLangProj80 (v VSLangProj80.dll)

Syntaxe

'Deklarace
Function AddWebReference ( _
    bstrUrl As String _
) As ProjectItem

ProjectItem AddWebReference(
    string bstrUrl
)

ProjectItem^ AddWebReference(
    [InAttribute] String^ bstrUrl
)

abstract AddWebReference : 
        bstrUrl:string -> ProjectItem 

function AddWebReference(
    bstrUrl : String
) : ProjectItem

Parametry

  • bstrUrl
    Typ: System.String
    Povinné.Obvykle je URL název souboru s příponou .disco nebo .vsdisco.

Vrácená hodnota

Typ: EnvDTE.ProjectItem
Vrátí ProjectItem objektu, který je nový odkaz webové složky.

Implementuje

VSProject.AddWebReference(String)

Poznámky

Pokud WebReferencesFolder je Nothing ( nullodkaz Null (Nothing v jazyce Visual Basic) odkaz), pak ProjectItem odkazů na Web projektu je vytvořena a WebReferencesFolder je nastavit.

Při vytvoření webu odkaz na webovou službu, nový typ složky ProjectItem, přidané v projektu ProjectItems kolekce. Tento nový ProjectItem obsahuje v jeho ProjectItems vlastnost, jednotlivé položky, které tvoří referenční specifikace Web. V následující tabulce jsou popsány čtyři typy položek, které jsou součástí specifikace odkaz na Web.

Položka

Účel

Soubor mapy (Reference.map)

Tento soubor XML mapy umístění místní mezipaměti souboru URL. Zobrazí seznam vyhledávání souborů a soubory služby smlouvy pro webové služby.

Soubory servisní smlouvy (.wsdl)

Zadejte tyto soubory protokolu SOAP rozhraní webové služby. Referenční webové složky může být více než jeden soubor smlouvy.

Soubory definice schématu XML (XSD)

Tyto soubory obsahují definice schémat XML pro webovou službu. Referenční webové složky může být více než jeden soubor schématu.

Vyhledání souboru (.disco nebo .vsdisco)

Tento soubor XML obsahuje odkazy na jiné zdroje, které popisují webové služby.

Příklady

Tento příklad přidá webové služby Visual Basic nebo Visual C# projektu. Před spuštěním tohoto vzorku nahradit bstrUrl parametr: https://ServerName/Application/myServiceName.asmx, skutečné adresy URL. Chcete-li spustit tento příklad-in, viz How to: Compile and Run the Automation Object Model Code Examples.

Visual Basic

' Add-in code.
Imports VSLangProj
Imports VSLangProj80
Public Sub OnConnection(ByVal application As Object,_
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    applicationObject = CType(application, DTE2)
    addInInstance = CType(addInInst, AddIn)
    AddWebReferenceExample(applicationObject)
End Sub
Sub AddWebReferenceExample(ByVal dte As DTE2)
    ' This example assumes that the first project in the solution is 
    ' a Visual Basic or C# project.
    Dim aVSProject As VSProject2 = _
    CType(applicationObject.Solution.Projects.Item(1).Object, _
    VSProject2)
    ' The new project item is a folder.
    Dim newFolder As ProjectItem
    ' Replace the sample URL with an actual URL.
    newFolder = aVSProject.AddWebReference( _
    "https://ServerName/Application/myServiceName.asmx")
    ' The new name of the folder appears in Solution Explorer.
    newFolder.Name = "NewName"
    ' The ProjectItems collection for the folder is not empty.
    MsgBox(newFolder.ProjectItems.Count.ToString())
End Sub

[C#]

using System.Windows.Forms;
using VSLangProj;
using VSLangProj2;
using VSLangProj80;

public void OnConnection(object application, ext_ConnectMode
 connectMode, object addInInst, ref Array custom)
{
    applicationObject = (DTE2)application;
    addInInstance = (AddIn)addInInst;
    AddWebReferenceExample((DTE2)applicationObject);
}

public void AddWebReferenceExample(DTE2 dte)
{
    // This example assumes that the first project in the solution is 
    // a Visual Basic or C# project.
    VSProject2 aVSProject =
 ((VSProject2)( applicationObject.Solution.Projects.Item(1).Object));
    // The new project item is a folder.
    ProjectItem newFolder = null;
    // Replace the sample URL with an actual URL.
    newFolder = aVSProject.AddWebReference
("https://ServerName/Application/myServiceName.asmx ");
    // The new name of the folder appears in Solution Explorer.
    newFolder.Name = "NewName";
    // The ProjectItems collection for the folder is not empty.
    MessageBox.Show("Number of items in the Web Reference folder: \n"
 + newFolder.ProjectItems.Count.ToString());
}

Zabezpečení rozhraní .NET Framework

Viz také

Odkaz

VSProject2 Rozhraní

AddWebReference – přetížení

VSLangProj80 – obor názvů