NamedRange.ApplyNames 메서드
NamedRange 컨트롤의 셀에 이름을 적용합니다.
네임스페이스: Microsoft.Office.Tools.Excel
어셈블리: Microsoft.Office.Tools.Excel(Microsoft.Office.Tools.Excel.dll)
구문
‘선언
Function ApplyNames ( _
Names As Object, _
IgnoreRelativeAbsolute As Object, _
UseRowColumnNames As Object, _
OmitColumn As Object, _
OmitRow As Object, _
Order As XlApplyNamesOrder, _
AppendLast As Object _
) As Object
Object ApplyNames(
Object Names,
Object IgnoreRelativeAbsolute,
Object UseRowColumnNames,
Object OmitColumn,
Object OmitRow,
XlApplyNamesOrder Order,
Object AppendLast
)
매개 변수
- Names
형식: System.Object
적용할 이름 배열입니다.이 인수를 생략하면 시트의 모든 이름이 범위에 적용됩니다.
- IgnoreRelativeAbsolute
형식: System.Object
이름이나 참조의 참조 형식에 관계없이 참조를 이름으로 바꾸려면 true이고, 절대 참조는 절대 이름으로만 바꾸고 상대 참조는 상대 이름으로만 바꾸고 혼합 참조는 혼합 이름으로만 바꾸려면 false입니다.기본값은 true입니다.
- UseRowColumnNames
형식: System.Object
범위의 이름을 찾을 수 없는 경우 지정된 범위가 포함된 행 및 열 범위의 이름을 사용하려면 true이고, OmitColumn 및 OmitRow 인수를 무시하려면 false입니다.기본값은 true입니다.
- OmitColumn
형식: System.Object
전체 참조를 행 기반 이름으로 바꾸려면 true입니다.참조되는 셀이 수식과 동일한 열에 있고 행 기반 이름 범위 내에 있는 경우에만 열 기반 이름을 생략할 수 있습니다.기본값은 true입니다.
- OmitRow
형식: System.Object
전체 참조를 열 기반 이름으로 바꾸려면 true입니다.참조되는 셀이 수식과 동일한 행에 있고 열 기반 이름 범위 내에 있는 경우에만 행 기반 이름을 생략할 수 있습니다.기본값은 true입니다.
- Order
형식: Microsoft.Office.Interop.Excel.XlApplyNamesOrder
셀 참조를 행 기반 범위 이름과 열 기반 범위 이름으로 바꿀 경우 먼저 나열할 범위 이름을 결정합니다.
다음 XlApplyNamesOrder 상수 중 하나일 수 있습니다.
xlColumnThenRow
xlRowThenColumn
- AppendLast
형식: System.Object
Names의 이름 정의를 바꾸고 마지막으로 정의된 이름 정의도 바꾸려면 true이고, Names의 이름 정의만 바꾸려면 false입니다.기본값은 false입니다.
반환 값
형식: System.Object
설명
Array 함수를 사용하여 Names 인수의 이름 목록을 만들 수 있습니다.
이름을 전체 시트에 적용하려면 Cells.ApplyNames를 사용합니다.
이름 "적용을 취소"하여 이름을 삭제할 수는 없습니다. Delete 메서드를 사용해야 합니다.
선택적 매개 변수
선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하십시오.
예제
다음 코드 예제에서는 ApplyNames 메서드를 사용하여 이름 집합을 NamedRange 컨트롤에 적용합니다.
이 예제는 문서 수준 사용자 지정을 위한 것입니다.
Private Sub AddNames()
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
"namedRange1")
Dim s() As String = {"One", "Two", "Three", "Four", "Five"}
namedRange1.ApplyNames(s, True, True, True, True, _
Excel.XlApplyNamesOrder.xlColumnThenRow, False)
End Sub
private void AddNames()
{
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1", "A5"],
"namedRange1");
string[] s = new string[] { "One", "Two", "Three", "Four", "Five" };
namedRange1.ApplyNames(s, true, true, true, true,
Excel.XlApplyNamesOrder.xlColumnThenRow, false);
}
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.