ControlCollection.AddNamedRange Yöntem

Makale
02/17/2014

Yeni bir ekler NamedRange denetimini çalışma sayfasına belirtilen aralıkta.

Ad alanı: Microsoft.Office.Tools.Excel
Derleme: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll içinde)

Sözdizimi

'Bildirim
Function AddNamedRange ( _
    range As Range, _
    name As String _
) As NamedRange

NamedRange AddNamedRange(
    Range range,
    string name
)

Parametreler

range
Tür: Microsoft.Office.Interop.Excel.Range
A Range , sınırları için denetim sağlar.

name
Tür: System.String
Denetimde dizini oluşturmak için kullanılan denetimin adını ControlCollection örneği.

Dönüş Değeri

Tür: Microsoft.Office.Tools.Excel.NamedRange
NamedRange Eklenmiştir denetim ControlCollection örneği.

Özel Durumlar

Exception	Koşul
ArgumentNullException	Ad veya aralık bağımsız değişkeni nullnull başvuru (Visual Basic'te Nothing), veya sıfır uzunluk değişkeni vardır.
ControlNameAlreadyExistsException	Aynı ada sahip bir denetim zaten kullanılıyor ControlCollection örneği.
InvalidRangeException	Belirtilen aralık geçersiz.Multi-Area aralıkları kullanılamaz.Aralığı aynı çalışma sayfasında olması gerekir ControlCollection örneği.

Notlar

AddNamedRange Yöntemi eklemenizi sağlar NamedRange denetimleri sonuna kadar ControlCollection.Kaldırmak için bir NamedRange önceden programlı olarak eklenen Denetim, kullanım Remove yöntem.

Örnekler

Aşağıdaki kod örneği ekler bir NamedRange denetim hücreye A1ve sonra adlandırılmış aralığı değeri % 100'e ayarlar.

    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"],
        "namedRange1");
    namedRange1.Value2 = "100%";
}

.NET Framework Güvenliği

Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. Kısmen Güvenilen Koddan Kitaplıkları Kullanma.

Ayrıca bkz.

Başvuru

ControlCollection Arabirim

Microsoft.Office.Tools.Excel Ad Alanı

Aracılığıyla paylaş