IVsHierarchyRefactorNotify.OnBeforeGlobalSymbolRenamed(UInt32, UInt32[], UInt32, String[], String, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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);