Freigeben über


SPViewCollection.Add-Methode (String, StringCollection, String, UInt32, Boolean, Boolean, SPViewCollection.SPViewType, Boolean)

Erstellt eine Ansicht mit dem angegebenen Namen, Anzeigefelder, Abfrage, Zeilenlimit, boolesche Werte, die angibt, ob die Ansicht zeigt Elemente von Seite und ob sie ist die Standardansicht, den Ansichtstyp und einen booleschen Wert, der angibt, ob die Ansicht persönliche oder öffentliche ist in der Auflistung.

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

Syntax

'Declaration
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
'Usage
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
)

Parameter

  • strViewName
    Typ: System.String

    Eine Zeichenfolge, die den Namen der Ansicht enthält.

  • iRowLimit
    Typ: System.UInt32

    Die maximale Anzahl von Elementen, die in der Ansicht zurückzugeben. Angeben eines Werts, der größer als Int32.MaxValue (2.147.483.647 oder hexadezimal 0x7FFFFFFF) löst eine Ausnahme aus, da der Wert außerhalb des gültigen Bereichs ist.

  • bPaged
    Typ: System.Boolean

    true , um anzugeben, dass die Ansicht unterstützt weitere Artikel von Seite angezeigt werden können; andernfalls false.

  • bMakeViewDefault
    Typ: System.Boolean

    true der Ansicht als Standardansicht sein; andernfalls false.

  • bPersonalView
    Typ: System.Boolean

    true zum Erstellen einer persönlichen Ansicht; false eine öffentliche Ansicht erstellen.

Rückgabewert

Typ: Microsoft.SharePoint.SPView
Die neue Ansicht.

Ausnahmen

Ausnahme Bedingung
InvalidOperationException

Der angegebene Ansichtstyp ist für den Listentyp Vorlage ungültig.

Beispiele

Im folgenden Codebeispiel wird eine Rasteransicht erstellt und zeigt Objekte an, auf dem Wert eines Felds mit weniger als 1000 ist.

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);
}

Hinweis

Bestimmte Objekte, die IDisposable -Schnittstelle implementieren, und müssen Sie vermeiden, diese Objekte im Arbeitsspeicher beibehalten, wenn sie nicht mehr benötigt werden. Informationen zu bewährten Codierung finden Sie unter Disposing Objects.

Siehe auch

Referenz

SPViewCollection Klasse

SPViewCollection-Member

Add-Überladung

Microsoft.SharePoint-Namespace