Reference3.CopyLocal プロパティ

[アーティクル]
08/09/2011

参照を local bin のパスにコピーするかどうかを取得または設定します。

名前空間: VSLangProj80
アセンブリ: VSLangProj80 (VSLangProj80.dll 内)

構文

'宣言
Property CopyLocal As Boolean
    Get
    Set

bool CopyLocal { get; set; }

property bool CopyLocal {
    bool get ();
    void set (bool value);
}

abstract CopyLocal : bool with get, set

function get CopyLocal () : boolean
function set CopyLocal (value : boolean)

プロパティ値

型: System.Boolean
参照がコピーされるかどうかを示す boolean 値。

実装

Reference2.CopyLocal

解説

実行時に、グローバルアセンブリキャッシュまたはプロジェクトの出力パスのどちらかに参照が存在している必要があります。このプロパティに true を設定した場合、参照は実行時にプロジェクトの出力パスにコピーされます。

実行時に、アセンブリは、プロジェクトの出力パスまたはグローバルアセンブリキャッシュ (「アセンブリとグローバルアセンブリキャッシュの使用」を参照) のいずれかに存在している必要があります。どちらの場所にも存在しないオブジェクトへの参照がプロジェクトに含まれている場合は、プロジェクトをビルドするときに、その参照をプロジェクトの出力パスにコピーする必要があります。 CopyLocal プロパティは、コピーを作成するかどうかを示します。値が true の場合、参照がコピーされます。 false の場合、参照はコピーされません。

参照の変更を追跡してローカルコピーを更新するかどうかを判断するのは、共通言語ランタイムではありません。変更のトレースは、プロジェクトシステムが行います。ユーザーが CopyLocal プロパティをオーバーライドしない限り、プロジェクトシステムが必要に応じてプロパティの値を自動的に更新します。

プロジェクトが割り当てる CopyLocal プロパティの値は、次の順序で決定されます。

参照先が他のプロジェクトの場合 (プロジェクト間参照の場合) は、値を true に設定します。
参照が Visual Studio .NET Framework アセンブリの場合、この値は false です。
参照のアセンブリが、バージョン番号を除いて Visual Studio .NET Framework アセンブリの厳密な名前に一致する場合 (たとえば Visual Studio 2003 のアセンブリなど)、この値は false です。
参照のアセンブリが .NET Framework ディレクトリにある場合、この値は false です。
参照のアセンブリが GAC にある場合、この値は false です。
それ以外の場合、値は true になります。

数値 4 の上は数値 3 ではないことに注意してください。なぜなら、.NET Framework SDK フォルダーは、.NET Framework ディレクトリと同じではないためです。

例

この例では、開いた Visual Basic または Visual C# プロジェクトに含まれるすべての参照について、CopyLocal 値を表示します。このサンプルコードをアドインとして実行するには、「方法 : オートメーションオブジェクトモデルのコード例をコンパイルおよび実行する」を参照してください。

Imports VSLangProj
Imports VSLangProj2
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)
     DisplayCopyLocalValues(applicationObject)
End Sub
Public Sub DisplayCopyLocalValues(ByVal dte As DTE2)
    ' The first project is a Visual Basic or C# project.
    Dim vsProject As VSProject2 = _
    CType(applicationObject.Solution.Projects.Item(1).Object, _
    VSProject2)
    Dim aRef As Reference3
    Dim refStr As String
    refStr = ""
    For Each aRef In vsProject.References
        refStr += (aRef.Name & "'s CopyLocal value is:  " & _
        aRef.CopyLocal.ToString() & vbCr& vbCr)
    Next
    MsgBox(refStr)
End Sub

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;
    DisplayCopyLocalValues(((DTE2)applicationObject));
}
public void DisplayCopyLocalValues(DTE2 dte)
{
    // The first project is a Visual Basic or C# project.
    VSProject2 vsProject = 
((VSProject2)(applicationObject.Solution.Projects.Item(1).Object));
    Reference aRef = null;
    string refStr = null;
    refStr = "";
    foreach (VSLangProj80.Reference3 temp in vsProject.References)
    {
        aRef = temp;
        refStr += (aRef.Name + "'s CopyLocal value is:   " 
+ aRef.CopyLocal.ToString() + "\n" + "\n");
    }
    MessageBox.Show(refStr);
}