Reference.CopyLocal-Eigenschaft

Aktualisiert: November 2007

Legt fest, ob der Verweis in das lokale Bin-Verzeichnis kopiert wird.

Namespace:  VSLangProj
Assembly:  VSLangProj (in VSLangProj.dll)

Syntax

Property CopyLocal As Boolean

Dim instance As Reference
Dim value As Boolean

value = instance.CopyLocal

instance.CopyLocal = value
bool CopyLocal { get; set; }
property bool CopyLocal {
    bool get ();
    void set (bool value);
}
function get CopyLocal () : boolean
function set CopyLocal (value : boolean)

Eigenschaftenwert

Typ: System.Boolean

Boolescher Wert

Hinweise

Assemblys müssen sich zur Laufzeit an einem der beiden folgenden Orte befinden: im Ausgabepfad des Projekts oder im globalen Assemblycache (siehe Arbeiten mit Assemblys und dem globalen Assemblychache). Wenn das Projekt einen Verweis auf ein Objekt enthält, der sich nicht an einem der oben genannten Orte befindet, dann muss der Verweis beim Erstellen des Projekts in den Ausgabepfad des Projekts kopiert werden. Die CopyLocal-Eigenschaft gibt an, ob diese Kopie erstellt werden muss. Wenn der Wert auf true festgelegt wurde, wird der Verweis zur Laufzeit in den Ausgabepfad des Projekts kopiert. Wenn er false lautet, wird der Verweis nicht kopiert.

Die Common Language Runtime verfolgt die am Verweis vorgenommenen Änderungen nicht, um festzustellen, ob die lokale Kopie aktualisiert werden muss. Änderungen werden vom Projektsystem verfolgt. Solange der Benutzer die CopyLocal-Eigenschaft nicht überschrieben hat, wird der Wert bei Bedarf automatisch vom Projektsystem aktualisiert.

Der vom Projekt zugewiesene Wert von CopyLocal wird in der folgenden Reihenfolge bestimmt:

  1. Wenn es sich bei dem Verweis um ein anderes Projekt handelt, wird dieser als Verweis von Projekt zu Projekt bezeichnet und der Wert lautet true.

  2. Wenn sich die Assembly im globalen Assemblycache befindet, lautet der Wert false.

  3. Ein Sonderfall ist der Wert für den Verweis auf mscorlib.dll, der false lautet.

  4. Wenn sich die Assembly im Framework SDK-Ordner befindet, lautet der Wert false.

  5. In allen anderen Fällen lautet der Wert true.

Beispiele

Siehe das Beispiel in Reference.

Berechtigungen

Siehe auch

Referenz

Reference-Schnittstelle

Reference-Member

VSLangProj-Namespace