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

Artigo
05/12/2015

Cria uma exibição da coleção com o nome especificado, os campos de exibição, consulta, limite de linha e valores Boolean que especifica se o modo de exibição exibe itens de página por página e é o modo de exibição padrão.

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 _
) 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 returnValue As SPView

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

public SPView Add(
    string strViewName,
    StringCollection strCollViewFields,
    string strQuery,
    uint iRowLimit,
    bool bPaged,
    bool bMakeViewDefault
)

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 Collaborative Application Markup Language 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.

Valor retornado

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

Examples

O exemplo de código a seguir cria um modo de exibição que retorna os itens em que o valor de um campo é igual a um valor de texto especificado.

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><Eq>
        <FieldRef Name='<iterm>Field3_Name</iterm>'/>" _ 
    & "<Value Type='Text'><iterm>Text</iterm></Value></Eq></Where>"

views.Add(viewName, viewFields, query, 100, True, 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><Lt><FieldRef Name=\"Field3_Name\"/>" +
    "<Value Type=\"Integer\">1000</Value></Lt></Where>";

    collViews.Add(strViewName, collViewFields, strQuery, 100, true, false,
    Microsoft.SharePoint.SPViewCollection.SPViewType.Grid, 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