Metoda CodeElement2.RenameSymbol —

Artykuł
05/17/2015

Zmienia nazwę deklarowanych obiektu i aktualizuje wszystkie kod odwołania do obiektu w zakresie bieżącego projektu.

Przestrzeń nazw: EnvDTE80
Zestaw: EnvDTE80 (w EnvDTE80.dll)

Składnia

'Deklaracja
Sub RenameSymbol ( _
    NewName As String _
)

void RenameSymbol(
    string NewName
)

void RenameSymbol(
    String^ NewName
)

abstract RenameSymbol : 
        NewName:string -> unit

function RenameSymbol(
    NewName : String
)

Parametry

NewName
Typ: String

Wymagany.Nazwa symbolu, aby zmienić nazwę.

Uwagi

Jeśli jakakolwiek część zmiany nazwy nie można ukończyć (w ramach bieżącego zakresu projektu), metoda zwraca błąd.

[!UWAGA]

Nie można wywołać funkcji RenameSymbol lub ElementID latebound. (Na przykład: DTE.ActiveDocument.ProjectItem.FileCodeModel.CodeElements.Item("Class1").RenameSymbol("Class2").) Trzeba jawnie oddać obiekt do CodeElement2 interfejsu przed transmisją.

Kod elementów w EnvDTE80 (zwany dalej kod * 2 obiekty) dziedziczyć te w EnvDTE. (Na przykład CodeClass2 wynika z CodeClass, i CodeElement2 wynika z CodeElement.) Wewnętrznie w Visual Studio, wszystkie elementy kodu (w obu zestawów) z kolei są rzutowane na CodeElement2.Tak, logicznie rzecz biorąc, to tak, jakby CodeClass2, na przykład, ostatecznie pochodzi z CodeElement2.

Ponieważ dwa elementy są w rzeczywistości w dwóch hierarchii dziedziczenia oddzielnych, chociaż, latebinder nie może wyszukać CodeElement2 metody na kod * 2 obiekty.EnvDTEProgram Works zasadniczo identyczne, ale korzystania z makr preprocesorem pozwala interfejsów do zdefiniowania takie, że metody dziedziczone są jawnie zdefiniowane na wszystkich interfejsach pokrewne, dla których istnieją konwersji.EnvDTE80interfejsy są definiowane przy użyciu podobnych schemat dziedziczenia, tylko bez użycia instrukcji Pre-procesor.Jest to rozwiązanie bardziej eleganckim, ponieważ eliminuje zbędne właściwości, ale wynik jest, że właściwości nie można wywołać metody ustalania.Aby obejść ten problem, należy jawnie rzutowane obiektu do CodeElement2 interfejsu przed transmisją.

Ponadto wartości elementów modelu kodu, takich jak klasy, strukturach, funkcje, atrybuty, delegatów i tak dalej mogą być deterministyczny, po dokonaniu niektórych rodzajów modyfikacji, co oznacza, że ich wartości nie mogą być powoływane do zawsze pozostają takie same.Aby uzyskać więcej informacji, zobacz sekcję wartości elementu modelu kod można zmienić w Odnajdowanie kodu za pomocą modelu kodu (Visual Basic).

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.