DeploymentSyncOptions.WhatIf Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der bestimmt, ob Vorgänge ausgeführt werden sollen, oder legt diesen fest.
public:
property bool WhatIf { bool get(); void set(bool value); };public bool WhatIf { get; set; }member this.WhatIf : bool with get, setPublic Property WhatIf As BooleanEigenschaftswert
true , wenn die Option nicht ausgeführt werden soll, andernfalls false. Standardwert: false.
Beispiele
Im folgenden Beispiel wird die -Klasse DeploymentSyncOptionsimplementiert, indem die statische Methode GetAvailableRules aufgerufen wird, um derzeit verfügbare Regeln abzurufen, die für den Synchronisierungsvorgang gelten. Eine DeploymentSyncOptions Instanz ändert dann eigenschaften: WhatIf und UseChecksum.
Hinweis Die WhatIf -Eigenschaft ermöglicht die Durchführung einer Testsynchronisierung, um die Möglichkeit eines Synchronisierungsvorgangs zu ermitteln und eine Messung der Änderungen bereitzustellen, die bei der Verwendung in Verbindung mit einer Instanz von DeploymentChangeSummaryauftreten können.
using System;
using Microsoft.Web.Deployment;
namespace MSDeploy.Web.Deployment
{
class Program
{
static void Main(string[] args)
{
// List currently available rules
foreach(DeploymentRule rule in
DeploymentSyncOptions.GetAvailableRules())
{
Console.WriteLine("Description: " + rule.Description);
Console.WriteLine("ExampleOrDetail: " + rule.ExampleOrDetail);
Console.WriteLine("FriendlyName: " + rule.FriendlyName);
Console.WriteLine("Name: " + rule.Name);
Console.WriteLine("Handler: " +
rule.RuleHandler.ToString());
Console.WriteLine();
}
DeploymentSyncOptions syncOptions = new DeploymentSyncOptions();
syncOptions.WhatIf = true; // report expected results of
// syncing without performing a sync operation
syncOptions.UseChecksum = true; // compare files through
// checksum to determine if they should be synced
DeploymentBaseOptions sourceBaseOptions =
new DeploymentBaseOptions();
DeploymentBaseOptions destinationBaseOptions =
new DeploymentBaseOptions();
DeploymentObject deploymentObject =
DeploymentManager.CreateObject(
DeploymentWellKnownProvider.AppHostConfig,
"Default Web Site", sourceBaseOptions);
DeploymentChangeSummary changes =
deploymentObject.SyncTo(
DeploymentWellKnownProvider.AppHostConfig,
"Default Web Site2", destinationBaseOptions,
syncOptions);
Console.WriteLine("Added: " +
changes.ObjectsAdded.ToString());
Console.WriteLine("Updated: " +
changes.ObjectsUpdated.ToString());
Console.WriteLine("Deleted: " +
changes.ObjectsDeleted.ToString());
Console.WriteLine("Errors: " +
changes.Errors.ToString());
}
}
}
Hinweise
Wenn auf truefestgelegt ist, werden Vorgänge nicht ausgeführt, aber Ereignisse werden weiterhin über das <xref:Microsoft.Web.Deployment.DeploymentSyncOptions.Action> Ereignis ausgelöst, das angibt, was geschehen wäre. Wenn auf falsefestgelegt ist, werden die Synchronisierungsereignisse tatsächlich ausgelöst.