مشاركة عبر

NamedRange.Find أسلوب

  • مقالة

البحث عن معلومات معينة في NamedRangeعنصر التحكم، وإرجاع Microsoft.Office.Interop.Excel.Rangeالكائن الذي يمثل أول الخلية الموقع يتم العثور على تلك المعلومات.

مساحة الاسم:  Microsoft.Office.Tools.Excel
التجميع:  Microsoft.Office.Tools.Excel (في Microsoft.Office.Tools.Excel.dll)

بناء الجملة

'إقرار
Function Find ( _
    What As Object, _
    After As Object, _
    LookIn As Object, _
    LookAt As Object, _
    SearchOrder As Object, _
    SearchDirection As XlSearchDirection, _
    MatchCase As Object, _
    MatchByte As Object, _
    SearchFormat As Object _
) As Range

Range Find(
    Object What,
    Object After,
    Object LookIn,
    Object LookAt,
    Object SearchOrder,
    XlSearchDirection SearchDirection,
    Object MatchCase,
    Object MatchByte,
    Object SearchFormat
)

المعلمات

  • What
    النوع: System.Object
    بيانات إلى البحث عنها.يمكن أن تكون سلسلة أحرف أو أي نوع بيانات Excel Microsoft المكتب 2010 Suite.
  • After
    النوع: System.Object
    خلية التي تريد بحث بعدها إلى البدء.Th هو يتطابق مع موضع خلية نشطة عند إجراء بحث هو الانتهاء من واجهة مستخدم.ملاحظة ذلك Afterيجب أن تكون خلية واحدة في النطاق.تذكر أن يبدأ بحث بعد th هو خلية؛ الخلايا المحددة هو لا بحث إلى أن الأسلوب التفاف حول إعادة ترتيب هو خلية.إذا لم تقم بتعيين هذه وسيطة، يبدأ بحث بعد خلية الموجودة في أعلى-يسار الزاوية للنطاق.
  • MatchCase
    النوع: System.Object
    trueإلى إجراء بحث مع تحسس حالة أحرفه.القيمة الافتراضية هي false.
  • MatchByte
    النوع: System.Object
    استخدام فقط إذا قمت بتحديد أو قم بتثبيت دعم اللغة ذات بايت مزدوج.trueإلى أن تطابق الأحرف مزدوجة البايت أحرف مزدوجة البايت فقط؛falseإلى أن تتطابق مع الأحرف مزدوجة البايت بها المناظرة أحادية البايت.

القيمة المُرجعة

النوع: Microsoft.Office.Interop.Excel.Range
Microsoft.Office.Interop.Excel.Rangeالكائن الذي يمثل أول الخلية الموقع توجد المعلومات.

ملاحظات

Th هو الأسلوب بإرجاع nullمرجع خالٍ (لا شيء في Visual Basic)في حالة لا تطابق هو العثور على.

وهذا أسلوب لا يؤثر على تحديد أو خلية نشطة.

إعدادات ل LookIn، LookAt، SearchOrder، و MatchByteوتحفظ في كل مرة تقوم باستخدام هذا الأسلوب. إذا لم تحدد قيم هذه الوسيطات التالي وقت استدعاء الأسلوب، يتم استخدام القيم المحفوظة. تعيين الوسيطات التالية بتغيير الإعدادات في صندوق الحوار "بحث"، و تغيير الإعدادات في صندوق الحوار بحث تغيير قيم المحفوظة التي يتم استخدامها إذا قمت بحذف الوسيطة. إلى تجنب المشاكل، قم بتعيين الوسيطات التالية بوضوح في كل مرة باستخدام هذه الطريقة.

يمكنك استخدام FindNextو FindPreviousوظائف إلى تكرار بحث.

عندما يصل بحث إلى إنهاء نطاق بحث المحدد، فإنه يلتف حول إلى بداية النطاق. إلى sإلىp بحث عند حدوث هذه wraparound، وقم بحفظ عنوان اﻷول خلية تم العثور عليه، ثم قم بإجراء اختبار كل عنوان العثور على الخلية المتتالية ضد ذلك حفظ عنوان.

المعلمات الإختيارية

ل معلومات تشغيل معلمات اختيارية، راجع يفتقد المتغير و "المعلمات الاختيارية" في حلول Office.

أمثلة

مثال التعليمة البرمجية التالية يستخدم Findطريقة للبحث عن أول خلية بالقيمة Seashell في NamedRangeعنصر التحكم. مثال ثم يستخدم في FindNextو FindPreviousأساليب العثور على خلية التالية بالقيمة Seashell ثم قم بالرجوع إلى خلية الأصلي. وأخيراً، يستخدم المثال Cutأسلوب إلى قص محتويات الخلية الأولى بالقيمة من Seashell ولصقه في إلى الخلية B1.

Th هو المثال هو لتخصيص المستوى مستند.

    Private Sub FindValue()
        Me.Range("A1").Value2 = "Barnacle"
        Me.Range("A2").Value2 = "Seashell"
        Me.Range("A3").Value2 = "Star Fish"
        Me.Range("A4").Value2 = "Seashell"
        Me.Range("A5").Value2 = "Clam Shell"

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

        ' Find the first occurrence of "Seashell".
        Dim Range1 As Excel.Range = namedRange1.Find("Seashell", , , _
            Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns, _
            Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, _
            False, False, )

        ' Find the next occurrence of "Seashell".
        Range1 = namedRange1.FindNext(Range1)

        ' Return to the first occurrence of "Seashell".
        Range1 = namedRange1.FindPrevious(Range1)

        ' Cut the range with the first "Seashell" and copy it to cell B1.
        Dim namedRange2 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Range1, "namedRange2")
        namedRange2.Cut(Me.Range("B1"))
    End Sub


private void FindValue()
{
    this.Range["A1", missing].Value2 = "Barnacle";
    this.Range["A2", missing].Value2 = "Seashell";
    this.Range["A3", missing].Value2 = "Star Fish";
    this.Range["A4", missing].Value2 = "Seashell";
    this.Range["A5", missing].Value2 = "Clam Shell";

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

    // Find the first occurrence of "Seashell".
    Excel.Range Range1 = namedRange1.Find("Seashell", missing, missing,
        Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns,
        Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext,
        false, false, missing);

    // Find the next occurrence of "Seashell".
    Range1 = namedRange1.FindNext(Range1);

    // Return to the first occurrence of "Seashell".
    Range1 = namedRange1.FindPrevious(Range1);

    // Cut the range with the first "Seashell" and copy it to cell B1.
    Microsoft.Office.Tools.Excel.NamedRange namedRange2 =
        this.Controls.AddNamedRange(Range1, "namedRange2");
    namedRange2.Cut(this.Range["B1", missing]);
}

أمن NET Framework.

راجع أيضًَا

المرجع

NamedRange واجهة

NamedRange الأعضاء

Microsoft.Office.Tools.Excel مساحة الاسم