NamedRange.AutoComplete-Methode

Artikel
08/10/2011

Ruft eine AutoVervollständigen-Übereinstimmung aus der Liste ab.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
Function AutoComplete ( _
    String As String _
) As String

string AutoComplete(
    string String
)

Parameter

String
Typ: System.String
Die zu vervollständigende Zeichenkette.

Rückgabewert

Typ: System.String
Eine AutoVervollständigen-Übereinstimmung aus der Liste.

Hinweise

Wenn es keine AutoVervollständigen-Übereinstimmung gibt, oder wenn es mehr als einen Eintrag in der Liste gibt, der mit der zu vervollständigenden Zeichenfolge übereinstimmt, gibt diese Methode eine leere Zeichenfolge zurück.

Diese Methode funktioniert sogar, wenn das AutoVervollständigen-Feature deaktiviert ist.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der AutoComplete-Methode veranschaulicht. Zunächst wird in diesem Beispiel der Wert der Zelle A1 auf die Zeichenfolge "Martha lives on a vineyard" festgelegt, und es wird in Zelle A2 ein NamedRange-Steuerelement erstellt. Anschließend wird in diesem Beispiel mithilfe der AutoComplete-Methode eine AutoVervollständigen-Übereinstimmung mit der untergeordneten Zeichenfolge "Ma" abgerufen und der übereinstimmende Wert in dem NamedRange platziert.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    Private Sub FindMarthaInTheRange()
        Me.Range("A1").Value2 = "Martha lives on a vineyard"

        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A2"), _
            "namedRange1")

        namedRange1.AddComment("This is Martha's range.")
        namedRange1.Value2 = namedRange1.AutoComplete("Ma")

        If MessageBox.Show("Clear the range?", "Test", _
            MessageBoxButtons.YesNo) = DialogResult.Yes Then
            namedRange1.Clear()
        End If
    End Sub

private void FindMarthaInTheRange()
{
    this.Range["A1", missing].Value2 = "Martha lives on a vineyard";

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A2", missing],
        "namedRange1");

    namedRange1.AddComment("This is Martha's range.");
    namedRange1.Value2 = namedRange1.AutoComplete("Ma");

    if (MessageBox.Show("Clear the range?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        namedRange1.Clear();
    }
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über