ControlParser.ParseControls(IDesignerHost, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria uma matriz de controles com base na marcação especificada usando o host de designer especificado.
public:
static cli::array <System::Web::UI::Control ^> ^ ParseControls(System::ComponentModel::Design::IDesignerHost ^ designerHost, System::String ^ controlText);
public static System.Web.UI.Control[] ParseControls (System.ComponentModel.Design.IDesignerHost designerHost, string controlText);
static member ParseControls : System.ComponentModel.Design.IDesignerHost * string -> System.Web.UI.Control[]
Public Shared Function ParseControls (designerHost As IDesignerHost, controlText As String) As Control()
Parâmetros
- designerHost
- IDesignerHost
Uma instância IDesignerHost que é o host do designer da página.
- controlText
- String
Uma cadeia de caracteres que representa uma coleção de marcação para controles.
Retornos
Uma matriz de elementos Control, analisados com base no controlText
; caso contrário, null
, se o analisador não puder criar os controles.
Exceções
designerHost
é null
.
- ou -
controlText
é null
ou uma cadeia de caracteres vazia ("").
Comentários
O ParseControls método acessa a cadeia de caracteres que representa as diretivas de registro na página da Web ASP.NET usando os serviços do host do designer. Os serviços de host do designer são adquiridos por meio da ReferenceManager propriedade do RootDesigner objeto ou, se isso não estiver disponível, o IWebFormReferenceManager serviço.
O ParseControls método gerará uma exceção se o analisador não puder criar os controles do controlText
parâmetro .