مشاركة عبر

ControlCollection.AddNamedRange أسلوب

  • مقالة

قم بإضافة جديد NamedRangeعنصر تحكم إلى ورقة عمل في النطاق المحدد.

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

بناء الجملة

'إقرار
Function AddNamedRange ( _
    range As Range, _
    name As String _
) As NamedRange

NamedRange AddNamedRange(
    Range range,
    string name
)

المعلمات

  • name
    النوع: System.String
    اسم عنصر التحكم الذي يمكن أن تستخدم لفهرسة عنصر التحكم في ControlCollectionمثيل.

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

النوع: Microsoft.Office.Tools.Excel.NamedRange
NamedRangeعنصر تحكم تمت إضافته إلى ControlCollectionالمثيل.

استثناءات

استثناء: شرط
ArgumentNullException

وسيطة اسم أو النطاق هو nullمرجع خالٍ (لا شيء في Visual Basic)، أو وسيطة "اسم" الطول الصفرية.
ControlNameAlreadyExistsException

عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل.
InvalidRangeException

النطاق الذي تم تحديده هو غير صالح. لا يمكن استخدام نطاقات multi-مساحة. يجب أن يكون النطاق ورقة عمل نفسها ك ControlCollectionمثيل.

ملاحظات

AddNamedRangeأسلوب تمكنك من إضافة NamedRangeعناصر التحكم إلى النهاية ControlCollection. لإزالة NamedRangeعنصر تحكم الذي تم مسبقاً إضافته برمجياً، استخدم Removeالأسلوب.

أمثلة

يلي تعليمات برمجية المثال يضيف على NamedRangeعنصر التحكم إلى خلية من A1، وثم يقوم بتعيين القيمة النطاق المسمى إلى 100%.

    Private Sub ExcelAddNamedRange()

        Dim NamedRange1 As Microsoft.Office.Tools. _
          Excel.NamedRange = Me.Controls.AddNamedRange( _
          Me.Range("A1"), "NamedRange1")
        NamedRange1.Value2 = "100%"

    End Sub


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

أمن NET Framework.

راجع أيضًَا

المرجع

ControlCollection واجهة

ControlCollection الأعضاء

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