Share via

Metodo NamedRange.Replace

  • Articolo

Sostituisce i caratteri specificati nel controllo NamedRange con una nuova stringa.

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
Function Replace ( _
    What As Object, _
    Replacement As Object, _
    LookAt As Object, _
    SearchOrder As Object, _
    MatchCase As Object, _
    MatchByte As Object, _
    SearchFormat As Object, _
    ReplaceFormat As Object _
) As Boolean

bool Replace(
    Object What,
    Object Replacement,
    Object LookAt,
    Object SearchOrder,
    Object MatchCase,
    Object MatchByte,
    Object SearchFormat,
    Object ReplaceFormat
)

Parametri

  • What
    Tipo: System.Object
    Stringa che si desidera cercare in Microsoft Office Excel.
  • MatchCase
    Tipo: System.Object
    true per rilevare la distinzione tra maiuscole e minuscole durante la ricerca.
  • MatchByte
    Tipo: System.Object
    È possibile utilizzare questo argomento solo se è stato selezionato o installato il supporto per caratteri DBCS in Excel.true affinché i caratteri DBCS corrispondano solo a caratteri DBCS; false affinché i caratteri DBCS corrispondano agli equivalenti caratteri SBCS.
  • SearchFormat
    Tipo: System.Object
    Formato di ricerca per il metodo.
  • ReplaceFormat
    Tipo: System.Object
    Formato di sostituzione per il metodo.

Valore restituito

Tipo: System.Boolean
true se i caratteri specificati sono inclusi in celle all'interno del controllo NamedRange; in caso contrario, false.

Note

L'utilizzo di questo metodo non implica la modifica della selezione o della cella attiva.

Le impostazioni dei parametri LookAt, SearchOrder, MatchCase e MatchByte vengono salvate ogni volta che si utilizza questo metodo. Se non si specificano i valori per questi argomenti, per la successiva chiamata al metodo saranno utilizzati i valori salvati. L'impostazione di questi argomenti implica la modifica delle impostazioni nella finestra di dialogo Trova. La modifica delle impostazioni in questa finestra implica la modifica dei valori salvati che vengono utilizzati se questi argomenti vengono omessi. Per evitare problemi, impostare questi argomenti in modo esplicito ogni volta che si utilizza questo metodo.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito il valore delle celle nel controllo NamedRange viene impostato sulla stringa "This is a sentence.". Viene quindi utilizzato il metodo Replace per sostituire la parola "a" con "my".

Questo esempio è valido per una personalizzazione a livello di documento.

    Private Sub ReplaceValue()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1"), _
            "namedRange1")

        namedRange1.Value2 = "This is a sentence."
        namedRange1.Replace("a", "my", Excel.XlLookAt.xlPart, _
            Excel.XlSearchOrder.xlByColumns, False, , , )
    End Sub


private void ReplaceValue()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", missing],
        "namedRange1");

    namedRange1.Value2 = "This is a sentence.";
    namedRange1.Replace("a", "my", Excel.XlLookAt.xlPart,
        Excel.XlSearchOrder.xlByColumns, false, missing,
        missing, missing);
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel