RequiresProvidesDirectiveProcessor.InitializeRequiresDictionary 方法

發行項
10/31/2012

在衍生類別中覆寫時，為每個指示詞指定 requires 參數。

命名空間： Microsoft.VisualStudio.TextTemplating
組件： Microsoft.VisualStudio.TextTemplating.11.0 (在 Microsoft.VisualStudio.TextTemplating.11.0.dll 中)

語法

'宣告
Protected MustOverride Sub InitializeRequiresDictionary ( _
    directiveName As String, _
    requiresDictionary As IDictionary(Of String, String) _
)

protected abstract void InitializeRequiresDictionary(
    string directiveName,
    IDictionary<string, string> requiresDictionary
)

protected:
virtual void InitializeRequiresDictionary(
    String^ directiveName, 
    IDictionary<String^, String^>^ requiresDictionary
) abstract

abstract InitializeRequiresDictionary : 
        directiveName:string * 
        requiresDictionary:IDictionary<string, string> -> unit

protected abstract function InitializeRequiresDictionary(
    directiveName : String, 
    requiresDictionary : IDictionary<String, String>
)

參數

directiveName
型別：System.String
指示詞的名稱。

requiresDictionary
型別：System.Collections.Generic.IDictionary<String, String>
IDictionary ，包含這個處理器需要的標準參數。

備註

使用這個方法將索引鍵/值組加入到 requiresDictionary 參數。索引值是指示詞處理器支援之 requires 參數的名稱。如果使用者呼叫指示詞時並未指定不同的值，則參數的值為預設值。

您可以在參數的值插槽中放入 nullNull 參照 (即 Visual Basic 中的 Nothing)，以表示使用者必須指定它。

這個方法是由 ProcessDirective 呼叫。

範例

下列範例設定這個指示詞處理器所需要的項目字典。這個程式碼範例是 RequiresProvidesDirectiveProcessor 類別完整範例的一部分。

protected override void InitializeRequiresDictionary(string directiveName, IDictionary<string, string> requiresDictionary)
{
if (StringComparer.InvariantCultureIgnoreCase.Compare(directiveName, DomDirectiveTag) == 0)
{
// Initialize the dictionary with nulls for each required parameter.
requiresDictionary[XmlFileRequiredParameterName] = null;
}
}