VSProject2.AddWebReference – metoda

Článek
05/16/2015

Do projektu přidán odkaz na webovou službu.Novou podsložku referenční webové služby je přidána do složky webové odkazy projektu.Tato nová složka obsahuje několik položek projektu vztahující se k webové službě.Metoda vrátí ProjectItem objektu 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: String

Povinné.Obvykle se jedná o adresu URL název souboru s příponou .disco nebo .vsdisco.

Vrácená hodnota

Typ: ProjectItem
Vrátí ProjectItem objekt, který je do nové složky webového odkazu.

Poznámky

Pokud WebReferencesFolder je Nothing ( nullodkaz null (Nothing v jazyce Visual Basic) odkaz), pak ProjectItem pro odkazy na Web projektu je vytvořena a WebReferencesFolder je nastaven.

Při vytvoření webového odkazu na webovou službu, nový typ složky, ProjectItem, je přidán do 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 webový odkaz.

Položka	Účel
Soubor mapy (Reference.map)	Tento soubor XML mapování adresy URL do umístění místního souboru v mezipaměti.Zobrazí se seznam soubor zjišťování a smlouvy soubory služby webové služby.
Soubory servisní smlouvy (WSDL)	Tyto soubory protokolu SOAP určit rozhraní webové služby.Ve složce webového odkazu může být více než jeden soubor smlouvy.
Soubory definice schématu XML (XSD)	Tyto soubory obsahují definice schémat XML webové služby.Ve složce webového odkazu může být více než jeden soubor schématu.
Soubor zjišťování (.disco nebo .vsdisco)	Tento soubor XML obsahuje odkazy na další zdroje, které popisují webovou službu.

Příklady

V tomto příkladu přidá webovou službu, která Visual Basic nebo Visual C# projektu.Před spuštěním tohoto příkladu, nahradí bstrUrl parametru: https://ServerName/Application/myServiceName.asmx, s skutečné adresy URL.Chcete-li spustit tento příklad jako doplněk, viz Postupy: Kompilace a spuštění příkladů kódu objektu automatizace.

[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

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

VSProject2 Rozhraní

VSLangProj80 – obor názvů

Share via