ControlCollection.AddNamedRange Yöntem
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.