具有指定名称的插入代码段在文本缓冲区中的指定位置。
命名空间： Microsoft.VisualStudio.TextManager.Interop
程序集： Microsoft.VisualStudio.TextManager.Interop.8.0（在 Microsoft.VisualStudio.TextManager.Interop.8.0.dll 中）
语法
声明
Function InsertNamedExpansion ( _
bstrTitle As String, _
bstrPath As String, _
tsInsertPos As TextSpan, _
pExpansionClient As IVsExpansionClient, _
guidLang As Guid, _
fShowDisambiguationUI As Integer, _
<OutAttribute> ByRef pSession As IVsExpansionSession _
) As Integer
int InsertNamedExpansion(
string bstrTitle,
string bstrPath,
TextSpan tsInsertPos,
IVsExpansionClient pExpansionClient,
Guid guidLang,
int fShowDisambiguationUI,
out IVsExpansionSession pSession
)
int InsertNamedExpansion(
[InAttribute] String^ bstrTitle,
[InAttribute] String^ bstrPath,
[InAttribute] TextSpan tsInsertPos,
[InAttribute] IVsExpansionClient^ pExpansionClient,
[InAttribute] Guid guidLang,
[InAttribute] int fShowDisambiguationUI,
[OutAttribute] IVsExpansionSession^% pSession
)
abstract InsertNamedExpansion :
bstrTitle:string *
bstrPath:string *
tsInsertPos:TextSpan *
pExpansionClient:IVsExpansionClient *
guidLang:Guid *
fShowDisambiguationUI:int *
pSession:IVsExpansionSession byref -> int
function InsertNamedExpansion(
bstrTitle : String,
bstrPath : String,
tsInsertPos : TextSpan,
pExpansionClient : IVsExpansionClient,
guidLang : Guid,
fShowDisambiguationUI : int,
pSession : IVsExpansionSession
) : int
参数
bstrTitle
类型：String[in] 代码段的全名。
bstrPath
类型：String[在代码段文件的完整路径。
tsInsertPos
类型：Microsoft.VisualStudio.TextManager.Interop.TextSpan[in] 在文本缓冲区指定位置插入代码段。
pExpansionClient
类型：Microsoft.VisualStudio.TextManager.Interop.IVsExpansionClient[in] 接收有关插入的通知处理。 这可能是 nullnull 引用（在 Visual Basic 中为 Nothing） 值。
guidLang
类型：Guid[in] 语言服务的 GUID。 可以为 nullnull 引用（在 Visual Basic 中为 Nothing）。 默认值为文件的语言服务。
fShowDisambiguationUI
类型：Int32[in] 这是非零 (true)，如果 “消除用户界面 (UI)”中找到同名的多个代码段的用例可显示。 如果此值为零 (false) 因此与该名称插入的第一个代码段。
pSession
类型：Microsoft.VisualStudio.TextManager.Interop.IVsExpansionSession%[out] 返回使用的 IVsExpansionSession 对象，而此代码段就地编辑。
返回值
类型：Int32
如果方法成功，则返回 S_OK。如果失败，它会返回一个错误代码。
备注
COM 签名
从 textmgr2.idl:
HRESULT IVsExpansion::InsertNamedExpansion(
[in]BSTR bstrTitle,
[in] BSTR bstrPath,
[in] TextSpan tsInsertPos,
[in]IVsExpansionClient *pExpansionClient,
[in]GUID guidLang,
[in] bool fShowDisambiguationUI,
[out] IVsExpansionSession **pSession
);
，当代码段的名称和路径是已知时，此方法使用了插入一个代码段。 名称和路径可以从代码段的快捷方式通过调用获取在 IVsExpansionManager 接口的 M:Microsoft.VisualStudio.TextManager.Interop.IVsExpansionManager.GetExpansionByShortcut(Microsoft.VisualStudio.TextManager.Interop.IVsExpansionClient,System.Guid,System.String,Microsoft.VisualStudio.TextManager.Interop.IVsTextView,Microsoft.VisualStudio.TextManager.Interop.TextSpan[],System.Int32,System.String@,System.String@) 方法。
，同时使 OnItemChosen 方法代码段的名称和路径，该方法从 OnItemChosen 方法的实现。 IVsExpansionClient 接口的典型的调用。
如果提供 IVsExpansionClient 对象，它在 (OnBeforeInsertion 方法之前) 接收，并在 (OnAfterInsertion 方法) 通知之后插入过程。 展开客户端还用于验证该代码段 (IsValidKind 方法) 确定该代码段可能在指定的位置实际插入。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息，请参阅通过部分受信任的代码使用库。