_Table.Restrict(String) Método

Definição

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Aplica um filtro às linhas no Table e obtém um novo objeto Table .

public:
 Microsoft::Office::Interop::Outlook::Table ^ Restrict(System::String ^ Filter);

public Microsoft.Office.Interop.Outlook.Table Restrict (string Filter);

Public Function Restrict (Filter As String) As Table

Parâmetros

Filter

String

Especifica os critérios para as linhas do objeto Table.

Retornos

Table

Um objeto Table que é retornado aplicando-se Filter às linhas no objeto Table pai.

Comentários

Você só pode usar Table.Restrict para aplicar outro filtro a essa Tabela se o objeto pai da Tabela for um Folder objeto. Se o objeto pai for um Search objeto, o Restrict retornará um erro.

Como o filtro é aplicado às linhas no objeto Table, isso é equivalente à aplicação de um filtro que é um AND lógico de Filter e todos os filtros anteriores aplicados ao mesmo objeto Table .

Filter é uma consulta em propriedades especificadas de itens que são representados como linhas na Tabela pai. A consulta usa a sintaxe do Microsoft Jet ou a sintaxe do DAV Searching and Locating (DASL). Por exemplo, o seguinte filtro Jet e filtro DASL especificam os mesmos critérios para itens com LastModificationTime anteriores ao 3:30 pm de 12 de junho de 2005:

critérios = "[LastModificationTime] < '" & Format$("12/6/2005 3:30PM","Data Geral") & "'"

critérios = "@SQL=" & Chr(34) & "DAV:getlastmodified" & Chr(34) & " " < " & Format$("12/6/2005 3:30PM","General Date") & "'"

Para obter mais informações sobre como especificar filtros para o objeto Table , confira Filtragem de Itens

Se Filter contiver propriedades personalizadas, essas propriedades devem existir na pasta pai do objeto Table para que a restrição funcione corretamente. Determinadas propriedades não são suportadas em um filtro de tabela, incluindo propriedades binárias, propriedades computadas e conteúdo do corpo HTML ou RTF. Para obter mais informações, consulte Propriedades sem suporte em um objeto de tabela ou filtro de tabela

Se Filter for uma cadeia de caracteres em branco, Restringir retornará um objeto Table idêntico ao objeto Table pai.