Бөлісу құралы:

TemplateControl.LoadControl Метод

Определение

Пространство имен:
System.Web.UI
Сборка:
System.Web.dll

ControlЗагружает объект .

Перегрузки

Имя Описание
LoadControl(String)

Control Загружает объект из файла на основе указанного виртуального пути.
LoadControl(Type, Object[])

Control Загружает объект на основе заданных параметров типа и конструктора.

Комментарии

При загрузке элемента управления контейнера контейнер вызывает все события добавленного элемента управления до тех пор, пока он не поймал текущее событие. Однако добавленный элемент управления не догоняет обработку данных обратной передачи. Чтобы добавленный элемент управления участвовал в обработке данных обратной передачи, включая проверку, элемент управления должен быть добавлен в Init событие, а не в событии Load .

LoadControl(String)

Control Загружает объект из файла на основе указанного виртуального пути.

public:
 System::Web::UI::Control ^ LoadControl(System::String ^ virtualPath);
public System.Web.UI.Control LoadControl(string virtualPath);
member this.LoadControl : string -> System.Web.UI.Control
Public Function LoadControl (virtualPath As String) As Control

Параметры

virtualPath
String

Виртуальный путь к файлу элемента управления.

Возвращаемое значение

Control

Возвращает указанный Controlобъект.

Исключения

ArgumentNullException

Виртуальный путь или null пуст.

Примеры

В следующем примере кода показано, как использовать LoadControl метод для добавления пользовательского элемента управления на страницу ASP.NET.

В методе OnInit события эта страница использует LoadControl метод для программного создания пользовательского элемента управления на странице. Метод добавляет элемент управления Controls в свойство PlaceHolder элемента управления веб-сервера с именем Placeholder1.

Определение класса, используемого MyControl в этом примере кода, см. в разделе TemplateControl.

void Page_Init(object sender, System.EventArgs e)
{
    // Instantiate the UserControl object
    MyControl myControl1 =
        (MyControl)LoadControl("TempControl_Samples1.ascx.cs");
    PlaceHolder1.Controls.Add(myControl1);
}

Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
    ' Obtain a UserControl object MyControl from the
    ' user control file TempControl_Samples1.ascx.vb
    Dim myControl1 As MyControl = CType(LoadControl("TempControl_Samples1.vb.ascx"), MyControl)
    Controls.Add(myControl1)
End Sub

Комментарии

Если элемент управления поддерживает кэширование, объект, возвращаемый из LoadControl метода, не Control является объектом, а является PartialCachingControl объектом. virtualPath Если параметр является относительным, путь загруженного элемента управления равен пути к путиTemplateControl.

При загрузке элемента управления контейнера контейнер вызывает все события добавленного элемента управления до тех пор, пока он не поймал текущее событие. Однако добавленный элемент управления не догоняет обработку данных обратной передачи. Чтобы добавленный элемент управления участвовал в обработке данных обратной передачи, включая проверку, элемент управления должен быть добавлен в Init событие, а не в событии Load .

См. также раздел

Применяется к

LoadControl(Type, Object[])

Control Загружает объект на основе заданных параметров типа и конструктора.

public:
 System::Web::UI::Control ^ LoadControl(Type ^ t, cli::array <System::Object ^> ^ parameters);
public System.Web.UI.Control LoadControl(Type t, object[] parameters);
member this.LoadControl : Type * obj[] -> System.Web.UI.Control
Public Function LoadControl (t As Type, parameters As Object()) As Control

Параметры

t
Type

Тип элемента управления.

parameters
Object[]

Массив аргументов, соответствующих числу, порядку и типу параметров вызываемого конструктора. Если parameters это пустой массив или nullконструктор, который не принимает параметров (конструктор без параметров), вызывается.

Возвращаемое значение

Control

Возвращает указанный UserControlобъект.

Комментарии

Если элемент управления пользователя поддерживает кэширование, объект, возвращаемый методом LoadControlUserControl , не является объектом, а является PartialCachingControl объектом.

При загрузке элемента управления контейнера контейнер вызывает все события добавленного элемента управления до тех пор, пока он не поймал текущее событие. Однако добавленный элемент управления не догоняет обработку данных обратной передачи. Чтобы добавленный элемент управления участвовал в обработке данных обратной передачи, включая проверку, элемент управления должен быть добавлен в Init событие, а не в событии Load .

См. также раздел

Применяется к