IVsAddWebReferenceDlg3.ShowAddWebReferenceDialog 方法

顯示加入服務參考對話方塊。

命名空間：  Microsoft.VisualStudio.WCFReference.Interop
組件：  Microsoft.VisualStudio.WCFReference.Interop (在 Microsoft.VisualStudio.WCFReference.Interop.dll 中)

語法

'宣告
Sub ShowAddWebReferenceDialog ( _
    pProject As IVsHierarchy, _
    pDiscoverySession As IDiscoverySession, _
    referenceTypesAllowed As ServiceReferenceType, _
    pszDialogName As String, _
    pExistingReferenceGroup As IVsWCFReferenceGroup, _
    pszReferenceConfigContents As String, _
    <OutAttribute> ByRef ppReferenceResult As IVsAddWebReferenceResult, _
    <OutAttribute> ByRef pfCancelled As Integer _
)

void ShowAddWebReferenceDialog(
    IVsHierarchy pProject,
    IDiscoverySession pDiscoverySession,
    ServiceReferenceType referenceTypesAllowed,
    string pszDialogName,
    IVsWCFReferenceGroup pExistingReferenceGroup,
    string pszReferenceConfigContents,
    out IVsAddWebReferenceResult ppReferenceResult,
    out int pfCancelled
)

void ShowAddWebReferenceDialog(
    [InAttribute] IVsHierarchy^ pProject, 
    [InAttribute] IDiscoverySession^ pDiscoverySession, 
    [InAttribute] ServiceReferenceType referenceTypesAllowed, 
    [InAttribute] String^ pszDialogName, 
    [InAttribute] IVsWCFReferenceGroup^ pExistingReferenceGroup, 
    [InAttribute] String^ pszReferenceConfigContents, 
    [OutAttribute] IVsAddWebReferenceResult^% ppReferenceResult, 
    [OutAttribute] int% pfCancelled
)

abstract ShowAddWebReferenceDialog : 
        pProject:IVsHierarchy * 
        pDiscoverySession:IDiscoverySession * 
        referenceTypesAllowed:ServiceReferenceType * 
        pszDialogName:string * 
        pExistingReferenceGroup:IVsWCFReferenceGroup * 
        pszReferenceConfigContents:string * 
        ppReferenceResult:IVsAddWebReferenceResult byref * 
        pfCancelled:int byref -> unit

function ShowAddWebReferenceDialog(
    pProject : IVsHierarchy, 
    pDiscoverySession : IDiscoverySession, 
    referenceTypesAllowed : ServiceReferenceType, 
    pszDialogName : String, 
    pExistingReferenceGroup : IVsWCFReferenceGroup, 
    pszReferenceConfigContents : String, 
    ppReferenceResult : IVsAddWebReferenceResult, 
    pfCancelled : int
)

參數

• pProject
  類型：IVsHierarchy

  IVsHierarchy專案會加入參考。

• pDiscoverySession
  類型：IDiscoverySession

  IVsDiscoveryService中繼資料下載所使用的工作階段。

• referenceTypesAllowed
  類型：Microsoft.VisualStudio.WCFReference.Interop.ServiceReferenceType

  ServiceReferenceType的參考; 不論是哪一 Windows 通訊資格或 Web 服務 (ASMX) 使用 ASP。NET 中。

• pszDialogName
  類型：String

  A String所包含之對話方塊的標題。 可以是 Null。

• pExistingReferenceGroup
  類型：Microsoft.VisualStudio.WCFReference.Interop.IVsWCFReferenceGroup

  現有的 IVsWCFReferenceGroup。 可以是 Null。

• pszReferenceConfigContents
  類型：String

  A String所包含的組態內容。

• ppReferenceResult
  類型：Microsoft.VisualStudio.WCFReference.Interop.IVsAddWebReferenceResult%

  A IVsAddWebReferenceResult包含結果的物件。 可能是Null如果已取消的對話方塊。

• pfCancelled
  類型：Int32%

  Integer指定是否已取消的對話方塊。

備註

加入服務參考對話方塊，可讓使用者能夠指定中繼資料下載地址、 下載服務的中繼資料，並顯示服務的相關資訊。

如果服務的中繼資料下載是否成功，以及使用者關閉對話方塊，按一下 [ 確定，應該呼叫服務 (例如專案系統) 的取用者Save方法的傳回IVsAddWebReferenceResult物件。 這會導致新的 WCF 參考會加入至專案和產生服務 proxy。 IVsAddWebReferenceResult物件可以也快取和用來於稍後建立服務參考。

ShowAddWebReferenceDialog如果專案不支援存放裝置 」 服務，會立即失敗或VSPROPID_ServiceReferenceSupported專案的屬性不是，則為 true。

範例

下列範例會示範如何顯示加入服務參考對話方塊。

/// Add a service reference to the given project. 
private static IVsWCFReferenceGroup TryAddServiceReference
 (IVsHierarchy hierarchy, IServiceProvider serviceProvider,
 IDiscoverySession discoverySession)
{
    Debug.Assert(serviceProvider != null, "Why are we passing in a NULL
 service provider to a private method?");

    IVsAddWebReferenceDlg3 awrdlg = 
 serviceProvider.GetService(typeof(SVsAddWebReferenceDlg3))
 as IVsAddWebReferenceDlg3;
    IVsAddWebReferenceResult addWebReferenceResult = null;
    int cancelled = 1;

    if (awrdlg != null && hierarchy != null)
    {
        awrdlg.ShowAddWebReferenceDialog( 
            hierarchy, 
            discoverySession, 
            ServiceReferenceType.SRT_WCFReference, 
            null, 
            null, 
            null, 
            out addWebReferenceResult, 
            out cancelled);
    }

    if (addWebReferenceResult != null && cancelled == 0)
    {
        return addWebReferenceResult.Save() as IVsWCFReferenceGroup;
    }
    else
    {
         return null;
    }
}

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

IVsAddWebReferenceDlg3 介面

Microsoft.VisualStudio.WCFReference.Interop 命名空間