IVsHierarchyRefactorNotify.OnBeforeGlobalSymbolRenamed(UInt32, UInt32[], UInt32, String[], String, Int32) Methode

Definition

Wird aufgerufen, wenn ein Symbol im Begriff ist umbenannt werden.

public:
 int OnBeforeGlobalSymbolRenamed(System::UInt32 cItemsAffected, cli::array <System::UInt32> ^ rgItemsAffected, System::UInt32 cRQNames, cli::array <System::String ^> ^ rglpszRQName, System::String ^ lpszNewName, int promptContinueOnFail);
public:
 int OnBeforeGlobalSymbolRenamed(unsigned int cItemsAffected, Platform::Array <unsigned int> ^ rgItemsAffected, unsigned int cRQNames, Platform::Array <Platform::String ^> ^ rglpszRQName, Platform::String ^ lpszNewName, int promptContinueOnFail);
int OnBeforeGlobalSymbolRenamed(unsigned int cItemsAffected, std::Array <unsigned int> const & rgItemsAffected, unsigned int cRQNames, std::Array <std::wstring const &> const & rglpszRQName, std::wstring const & lpszNewName, int promptContinueOnFail);
public int OnBeforeGlobalSymbolRenamed (uint cItemsAffected, uint[] rgItemsAffected, uint cRQNames, string[] rglpszRQName, string lpszNewName, int promptContinueOnFail);
abstract member OnBeforeGlobalSymbolRenamed : uint32 * uint32[] * uint32 * string[] * string * int -> int
Public Function OnBeforeGlobalSymbolRenamed (cItemsAffected As UInteger, rgItemsAffected As UInteger(), cRQNames As UInteger, rglpszRQName As String(), lpszNewName As String, promptContinueOnFail As Integer) As Integer

Parameter

cItemsAffected
UInt32

Die Anzahl der Dateien, die vom Umbenennungsvorgang betroffen sind.

rgItemsAffected
UInt32[]

Ein Array von VSITEMIDs, das die Dateien identifiziert, die betroffen sein werden.

cRQNames
UInt32

Die Anzahl der umbenannten Symbole. Die Anzahl kann größer als eins sein, wenn ein überladenes Symbol umbenannt wird.

rglpszRQName
String[]

Der Name des Symbols vor der Umbenennung.

lpszNewName
String

Der Name des Symbols nach der Umbenennung.

promptContinueOnFail
Int32

true, um den Benutzer aufzufordern, den Umbenennungsvorgang fortzusetzen, wenn eine oder mehrere IVsRefactorNotify-Implementierungen fehlschlagen; andernfalls false.

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

Um den Umbenennungs Vorgang zu verhindern, muss das HRESULT einen der folgenden Fehlercodes enthalten:

E_ABORT

OLE_E_PROMPTSAVECANCELLED

OLECMDERR_E_CANCELED

HR_E_CSHARP_USER_CANCEL

Ein Symbol mit dem gleichen Namen kann mehr als ein Vorkommen aufweisen, wenn die Sprache überladende Vorgänge zulässt, wie z. b. das Überladen von Methoden:

void SomeMethod() {}  
void SomeMethod(int i) {}  

COM-Signatur

Aus vsshell80. idl:

HRESULT OnBeforeGlobalSymbolRenamed(  
    [in] ULONG cItemsAffected,                                 
    [in, size_is(cItemsAffected)] VSITEMID rgItemsAffected[],  
    [in] ULONG cRQNames,                                       
    [in, size_is(cRQNames)] LPCOLESTR rglpszRQName[],          
    [in] LPCOLESTR lpszNewName,                                
    [in] BOOL promptContinueOnFail);                           

Gilt für