Metoda ControlCollection.AddNamedRange —
Dodaje nowy NamedRange formantu do arkusza, w zakresie określonym.
Przestrzeń nazw: Microsoft.Office.Tools.Excel
Zestaw: Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)
Składnia
'Deklaracja
Function AddNamedRange ( _
range As Range, _
name As String _
) As NamedRange
NamedRange AddNamedRange(
Range range,
string name
)
Parametry
- range
Typ: Microsoft.Office.Interop.Excel.Range
A Range do celów kontroli i zapewniających granice.
- name
Typ: System.String
Nazwa formantu, który może być używane do indeksowania formantu znajdującego się w ControlCollection wystąpienie.
Wartość zwracana
Typ: Microsoft.Office.Tools.Excel.NamedRange
NamedRange Kontroli, który został dodany do ControlCollection wystąpienie.
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentNullException | Argument Nazwa lub zakres jest nullodwołanie o wartości null (Nothing w języku Visual Basic), albo argumentu Nazwa ma zerową długość. |
| ControlNameAlreadyExistsException | Formant o tej samej nazwie jest już w ControlCollection wystąpienie. |
| InvalidRangeException | Określony zakres jest nieprawidłowy.Nie można użyć Multi-Area zakresów.Zakres powinien być na tym samym arkuszu co ControlCollection wystąpienie. |
Uwagi
AddNamedRange Metoda umożliwia dodanie NamedRange formanty na koniec ControlCollection.Aby usunąć NamedRange kontroli, jakie zostały uprzednio dodane programowo, użyj Remove metody.
Przykłady
Poniższy kod dodaje NamedRange formantu do komórki A1, a następnie ustawia wartość nazwanego zakresu do 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"],
"namedRange1");
namedRange1.Value2 = "100%";
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.