TagPrefixInfo 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
태그 관련 정보를 포함하는 구성 요소를 정의합니다.
public ref class TagPrefixInfo sealed : System::Configuration::ConfigurationElementpublic sealed class TagPrefixInfo : System.Configuration.ConfigurationElementtype TagPrefixInfo = class
inherit ConfigurationElementPublic NotInheritable Class TagPrefixInfo
Inherits ConfigurationElement- 상속
예제
이 예제에서는 값의 몇 가지 특성에 대해 선언적으로 지정 하는 방법에 설명 합니다 controls 의 구성원으로도 액세스할 수 있는 섹션은 TagPrefixInfo 클래스.
<system.web>
<pages>
<controls>
<!-- Searches all linked assemblies for the namespace -->
<add tagPrefix="MyTags1" namespace=" MyNameSpace "/>
<!-- Uses a specified assembly -->
<add tagPrefix="MyTags2" namespace="MyNameSpace"
assembly="MyAssembly"/>
<!-- Uses the specified source for the user control -->
<add tagprefix="MyTags3" tagname="MyCtrl" src="MyControl.ascx"/>
</controls>
</pages>
</system.web>
다음 코드 예제를 사용 하는 방법을 보여 줍니다는 TagPrefixInfo 태그 접두사 설정을 프로그래밍 방식으로 수정 하는 클래스입니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 PagesSection 클래스입니다.
// Get all current Controls in the collection.
for (int i = 0; i < pagesSection.Controls.Count; i++)
{
Console.WriteLine("Control {0}:", i);
Console.WriteLine(" TagPrefix = '{0}' ",
pagesSection.Controls[i].TagPrefix);
Console.WriteLine(" TagName = '{0}' ",
pagesSection.Controls[i].TagName);
Console.WriteLine(" Source = '{0}' ",
pagesSection.Controls[i].Source);
Console.WriteLine(" Namespace = '{0}' ",
pagesSection.Controls[i].Namespace);
Console.WriteLine(" Assembly = '{0}' ",
pagesSection.Controls[i].Assembly);
}
// Create a new TagPrefixInfo object.
System.Web.Configuration.TagPrefixInfo tagPrefixInfo =
new System.Web.Configuration.TagPrefixInfo("MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", "MyControl.ascx");
// Execute the Add Method.
pagesSection.Controls.Add(tagPrefixInfo);
// Add a TagPrefixInfo object using a constructor.
pagesSection.Controls.Add(
new System.Web.Configuration.TagPrefixInfo(
"MyCtrl", "MyNameSpace", "MyAssembly", "MyControl",
"MyControl.ascx"));
' Get all current Controls in the collection.
Dim j As Int32
For j = 0 To pagesSection.Controls.Count - 1
Console.WriteLine("Control {0}:", j)
Console.WriteLine(" TagPrefix = '{0}' ", _
pagesSection.Controls(j).TagPrefix)
Console.WriteLine(" TagName = '{0}' ", _
pagesSection.Controls(j).TagName)
Console.WriteLine(" Source = '{0}' ", _
pagesSection.Controls(j).Source)
Console.WriteLine(" Namespace = '{0}' ", _
pagesSection.Controls(j).Namespace)
Console.WriteLine(" Assembly = '{0}' ", _
pagesSection.Controls(j).Assembly)
Next
' Create a new TagPrefixInfo object.
Dim tagPrefixInfo As System.Web.Configuration.TagPrefixInfo = _
New System.Web.Configuration.TagPrefixInfo("MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", "MyControl.ascx")
' Execute the Add Method.
pagesSection.Controls.Add(tagPrefixInfo)
' Add a TagPrefixInfo object using a constructor.
pagesSection.Controls.Add( _
New System.Web.Configuration.TagPrefixInfo( _
"MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", _
"MyControl.ascx"))
설명
TagPrefixInfo 클래스를 사용 하면 프로그래밍 방식으로 액세스 하 고 구성 파일에 저장 된 태그 접두사 정보를 수정할 수 있습니다. ASP.NET으로 동일한 기능을 제공 @Register 지시문입니다. 태그 접두사 "네임 스페이스" ASP.NET에서 사용자 지정 컨트롤 및 제대로 작동 하려면 사용자 컨트롤에 대 한 포함 해야 하는 네임 스페이스와 어셈블리에 연결 합니다. TagPrefixInfo 개체의 구성원으로 저장 되는 TagPrefixCollection 개체입니다. TagPrefixCollection 클래스를 사용 하면 프로그래밍 방식으로 액세스 하 고 수정할 수 있습니다 합니다 controls 하위 섹션을 pages 구성 파일의 섹션입니다.
TagPrefixInfo 개체가 사용 하 여 컬렉션에 추가 됩니다는 add 요소와 값을 지정 합니다 tagPrefix 다른 관련 특성의 값과 함께 특성입니다. 기타 필요한 정보를 지정 된 태그 접두사를 사용 하 여 사용 하 여 컨트롤의 종류에 따라 다릅니다.
이 사용자 지정 컨트롤을 정의 해야 합니다 TagPrefix, Namespace, 및 Assembly 속성. Assembly 컨트롤이 애플리케이션 코드 디렉터리에 있으면 속성이 필요 하지 않습니다.
동일한 tagPrefix 여러 어셈블리 또는 네임 스페이스에 매핑할 값을 사용할 수 있습니다.
참고
소스를 지정 하면 사용자 컨트롤 자체 페이지와 같은 디렉터리에 수 없습니다. 이 경우 페이지를 로드 하려고 하면 런타임 오류를 가져옵니다.
생성자
| TagPrefixInfo(String, String, String, String, String) |
전달된 값을 사용하여 TagPrefixInfo 클래스의 새 인스턴스를 초기화합니다. |
속성
| Assembly |
컨트롤이 구현되어 있는 어셈블리의 이름을 가져오거나 설정합니다. |
| CurrentConfiguration |
현재 Configuration 인스턴스가 속해 있는 구성 계층 구조를 나타내는 최상위 ConfigurationElement 인스턴스에 대한 참조를 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| ElementInformation |
ElementInformation 개체의 사용자 지정할 수 없는 정보와 기능을 포함하는 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| ElementProperty |
ConfigurationElementProperty 개체 자체를 나타내는 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| EvaluationContext |
ContextInformation 개체의 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| HasContext |
CurrentConfiguration 속성이 |
| Item[ConfigurationProperty] |
이 구성 요소의 속성이나 특성을 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement) |
| Item[String] |
이 구성 요소의 속성, 특성 또는 자식 요소를 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement) |
| LockAllAttributesExcept |
잠긴 특성의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| LockAllElementsExcept |
잠긴 요소의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| LockAttributes |
잠긴 특성의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| LockElements |
잠긴 요소의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| LockItem |
요소가 잠겨 있는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement) |
| Namespace |
컨트롤이 속한 네임스페이스를 가져오거나 설정합니다. |
| Properties |
속성 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| Source |
사용자 정의 컨트롤이 들어 있는 파일의 이름과 경로를 가져오거나 설정합니다. |
| TagName |
사용자 정의 컨트롤의 이름을 가져오거나 설정합니다. |
| TagPrefix |
소스 파일 또는 네임스페이스와 어셈블리에 연결할 태그 접두사를 가져오거나 설정합니다. |