SPViewCollection.Add method (String, StringCollection, String, UInt32, Boolean, Boolean, SPViewCollection.SPViewType, Boolean)

Artigo
05/12/2015

Cria uma exibição da coleção com o nome especificado, exibir campos, consulta, limite de linha, valores Boolean especificando se o modo de exibição exibe itens de página por página e se é a exibição padrão, o tipo de exibição e um valor booleano que especifica se a exibição é pessoal ou pública.

Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaração
Public Function Add ( _
    strViewName As String, _
    strCollViewFields As StringCollection, _
    strQuery As String, _
    iRowLimit As UInteger, _
    bPaged As Boolean, _
    bMakeViewDefault As Boolean, _
    type As SPViewCollection.SPViewType, _
    bPersonalView As Boolean _
) As SPView
'Uso
Dim instance As SPViewCollection
Dim strViewName As String
Dim strCollViewFields As StringCollection
Dim strQuery As String
Dim iRowLimit As UInteger
Dim bPaged As Boolean
Dim bMakeViewDefault As Boolean
Dim type As SPViewCollection.SPViewType
Dim bPersonalView As Boolean
Dim returnValue As SPView

returnValue = instance.Add(strViewName, _
    strCollViewFields, strQuery, iRowLimit, _
    bPaged, bMakeViewDefault, type, bPersonalView)

public SPView Add(
    string strViewName,
    StringCollection strCollViewFields,
    string strQuery,
    uint iRowLimit,
    bool bPaged,
    bool bMakeViewDefault,
    SPViewCollection.SPViewType type,
    bool bPersonalView
)

Parâmetros

strViewName
Type: System.String

Uma seqüência de caracteres que contém o nome do modo de exibição.

strCollViewFields
Type: System.Collections.Specialized.StringCollection

Uma coleção que contém os nomes internos dos campos de exibição.

strQuery
Type: System.String

Uma seqüência de caracteres de Marcação idioma CAML (Collaborative Application) que contém a cláusula Where para a consulta.

iRowLimit
Type: System.UInt32

O número máximo de itens para retornar no modo de exibição. Especificando um valor maior do que Int32.MaxValue (2.147.483.647 ou hexadecimal 0x7FFFFFFF) lança uma exceção, pois o valor está fora do intervalo.

bPaged
Type: System.Boolean

true para especificar o modo de exibição oferece suporte a exibição mais itens por página; Caso contrário, false.

bMakeViewDefault
Type: System.Boolean

true para que a exibição do modo de exibição padrão; Caso contrário, false.

type
Type: Microsoft.SharePoint.SPViewCollection.SPViewType

Um valor de enumeração que especifica o tipo de exibição.

bPersonalView
Type: System.Boolean

true para criar uma exibição pessoal; false para criar uma exibição pública.

Valor retornado

Type: Microsoft.SharePoint.SPView
O novo modo de exibição.

Exceptions

Exception	Condition
InvalidOperationException	O tipo de modo de exibição especificado não é válido para o tipo de modelo de lista.

Examples

O exemplo de código a seguir cria uma exibição de grade e exibe itens onde um valor de campo é menor que 1.000.

Dim siteCollection As SPSite = SPControl.GetContextSite(Context)
Dim site As SPWeb = siteCollection.AllWebs("Site_Name")
Dim list As SPList = site.Lists("List_Name")
Dim views As SPViewCollection = list.Views

Dim viewName As String = "View_Name"

Dim viewFields As New System.Collections.Specialized.StringCollection()

viewFields.Add("Field1_Name")
viewFields.Add("Field2_Name")
viewFields.Add("Field3_Name")

Dim query As String = "<Where><Lt><FieldRef Name='<iterm>Field3_Name</iterm>'/>" _
    & "<Value Type='Integer'>1000</Value></Lt></Where>"

views.Add(viewName, viewFields, query, 100, True, False, Microsoft.SharePoint.SPViewCollection.SPViewType.Grid, False)

SPSite oSiteCollection = SPContext.Current.Site;
using (SPWeb oWebsite = oSiteCollection.AllWebs["Website_Name"])
{
    SPList oList = oWebsite.Lists["List_Name"];
    SPViewCollection collViews = oList.Views;

    string strViewName = "View_Name";

    System.Collections.Specialized.StringCollection collViewFields = new System.Collections.Specialized.StringCollection();

    collViewFields.Add("Field1_Name");
    collViewFields.Add("Field2_Name");
    collViewFields.Add("Field3_Name");

    string strQuery = "<Where><Eq><FieldRef Name=\"Field3_Name\"/>" +
        "<Value Type=\"Text\">Text</Value></Eq></Where>";

    collViews.Add(strViewName, collViewFields, strQuery, 100, true, false);
}

Dica

Determinados objetos implementam a interface IDisposable , e você deve evitar reter esses objetos na memória depois que eles não são mais necessários. Para obter informações sobre boas práticas de codificação, consulte Disposing Objects.

Ver também

Referência

SPViewCollection class

SPViewCollection members

Add overload

Microsoft.SharePoint namespace

Compartilhar via