Reference.CopyLocal-Eigenschaft

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

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

Syntax

'Declaration
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)

Eigenschaftswert

Typ: System.Boolean
Boolesch.

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.

.NET Framework-Sicherheit

Siehe auch

Referenz

Reference Schnittstelle

VSLangProj-Namespace