SPListItem.SystemUpdate method

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

Syntax

'宣告
Public Sub SystemUpdate
'用途
Dim instance As SPListItem

instance.SystemUpdate()

public void SystemUpdate()

備註

當您呼叫SystemUpdate方法時，觸發事件的修改報告中的變更和稽核記錄檔，但不是傳送提醒與屬性不降級到文件。

呼叫這個方法是呼叫SystemUpdate(Boolean)與false相同。

Examples

下列範例會使用SystemUpdate方法，對清單項目進行變更的主控台應用程式。

Imports System
Imports Microsoft.SharePoint

Module ConsoleApp
   Sub Main()
      Using site As SPSite = New SPSite("https://localhost")
         Using web As SPWeb = site.OpenWeb()

            Dim list As SPList = web.GetList("/lists/announcements/")
            If list.ItemCount > 0 Then
               ' Get an item to modify.
               Dim item As SPListItem = list.Items(0)

               ' Report the current state of the item.
               ReportState("Before", item)

               ' Modify it.
               If item.HasUniqueRoleAssignments Then
                  item.ResetRoleInheritance()
               Else
                  item.BreakRoleInheritance(True)
               End If

               ' Update without changing the modified time.
               item.SystemUpdate()

               ' Report the new state of the item.
               ReportState("After", item)
            End If

         End Using
      End Using

      Console.ReadLine()
   End Sub

   Sub ReportState(ByVal state As String, ByVal item As SPListItem)
      Console.WriteLine(state)
      Console.WriteLine("HasUniqueRoleAssigments: {0}", item.HasUniqueRoleAssignments)
      Console.WriteLine("Modified: {0}", item(SPBuiltInFieldId.Modified))
      If item.Fields.ContainsField("Modified_x0020_By") Then
         Console.WriteLine("Modified by: {0}", item(SPBuiltInFieldId.Modified_x0020_By))
      End If
      Console.WriteLine()
   End Sub

End Module

using System;
using Microsoft.SharePoint;

namespace Test
{
   class ConsoleApp
   {
      static void Main(string[] args)
      {
         using (SPSite site = new SPSite("https://localhost"))
         {
            using (SPWeb web = site.OpenWeb())
            {
               SPList list = web.GetList("/lists/announcements/");
               if (list.ItemCount > 0)
               {
                  // Get an item to modify.
                  SPListItem item = list.Items[0];

                  // Report the current state of the item.
                  ReportState("Before", item);

                  // Modify it.
                  if (item.HasUniqueRoleAssignments)
                     item.ResetRoleInheritance();
                  else
                     item.BreakRoleInheritance(true);

                  // Update without changing the modified time.
                  item.SystemUpdate();

                  // Report the new state of the item.
                  ReportState("After", item);
               }
            }
         }
         Console.ReadLine();
      }

      static void ReportState(string state, SPListItem item)
      {
         Console.WriteLine(state);
         Console.WriteLine("HasUniqueRoleAssigments: {0}", item.HasUniqueRoleAssignments);
         Console.WriteLine("Modified: {0}", item[SPBuiltInFieldId.Modified]);
         if (item.Fields.ContainsField("Modified_x0020_By"))
            Console.WriteLine("Modified by: {0}", item[SPBuiltInFieldId.Modified_x0020_By]);
         Console.WriteLine();
      }

   }
}

請參閱

參照

SPListItem class

SPListItem members

SystemUpdate overload

Microsoft.SharePoint namespace