/// <summary>
/// Creates an unparented ProjectOutputElement, wrapping an unparented XmlElement.
/// Validates the parameters.
/// Exactly one of item name and property name must have a value.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static ProjectOutputElement CreateDisconnected(string taskParameter, string itemType, string propertyName, ProjectRootElement containingProject)
{
ErrorUtilities.VerifyThrowArgument
(
(String.IsNullOrEmpty(itemType) ^ String.IsNullOrEmpty(propertyName)),
"OM_EitherAttributeButNotBoth",
XMakeElements.output,
XMakeAttributes.propertyName,
XMakeAttributes.itemName
);
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.output);
ProjectOutputElement output = new ProjectOutputElement(element, containingProject);
output.TaskParameter = taskParameter;
if (!String.IsNullOrEmpty(itemType))
{
output.ItemType = itemType;
}
else
{
output.PropertyName = propertyName;
}
return(output);
}
/// <summary>
/// Creates an unparented ProjectUsingTaskElement, wrapping an unparented XmlElement.
/// Validates the parameters.
/// Exactly one of assembly file and assembly name must have a value.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static ProjectUsingTaskElement CreateDisconnected(string taskName, string assemblyFile, string assemblyName, string runtime, string architecture, ProjectRootElement containingProject)
{
ErrorUtilities.VerifyThrowArgument
(
(String.IsNullOrEmpty(assemblyFile) ^ String.IsNullOrEmpty(assemblyName)),
"OM_EitherAttributeButNotBoth",
XMakeElements.usingTask,
XMakeAttributes.assemblyFile,
XMakeAttributes.assemblyName
);
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.usingTask);
ProjectUsingTaskElement usingTask = new ProjectUsingTaskElement(element, containingProject);
usingTask.TaskName = taskName;
usingTask.Runtime = runtime;
usingTask.Architecture = architecture;
if (!String.IsNullOrEmpty(assemblyFile))
{
usingTask.AssemblyFile = FileUtilities.FixFilePath(assemblyFile);
}
else
{
usingTask.AssemblyName = assemblyName;
}
return(usingTask);
}
/// <summary>
/// Creates an unparented ProjectTaskElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to the XmlDocument in the appropriate location.
/// </summary>
/// <remarks>
/// Any legal XML element name is allowed. We can't easily verify if the name is a legal XML element name,
/// so this will specifically throw XmlException if it isn't.
/// </remarks>
internal static ProjectTaskElement CreateDisconnected(string name, ProjectRootElement containingProject)
{
ErrorUtilities.VerifyThrowArgumentLength(name, "name");
XmlElementWithLocation element = containingProject.CreateElement(name);
return(new ProjectTaskElement(element, containingProject));
}
/// <summary>
/// Creates an unparented ProjectUsingTaskBodyElement, wrapping an unparented XmlElement.
/// Validates name.
/// Caller should then ensure the element is added to the XmlDocument in the appropriate location.
/// </summary>
internal static ProjectUsingTaskBodyElement CreateDisconnected(string evaluate, string body, ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.usingTaskBody);
ProjectUsingTaskBodyElement taskElement = new ProjectUsingTaskBodyElement(element, containingProject);
taskElement.Evaluate = evaluate;
taskElement.TaskBody = body;
return(taskElement);
}
/// <summary>
/// Creates an unparented ProjectImportElement, wrapping an unparented XmlElement.
/// Validates the project value.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static ProjectImportElement CreateDisconnected(string project, ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.import);
return(new ProjectImportElement(element, containingProject)
{
Project = project
});
}
/// <summary>
/// Creates an unparented ProjectTargetElement, wrapping an unparented XmlElement.
/// Validates the name.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectTargetElement CreateDisconnected(string name, ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.target);
return(new ProjectTargetElement(element, containingProject)
{
Name = name
});
}
/// <summary>
/// Creates an unparented ProjectPropertyElement, wrapping an unparented XmlElement.
/// Validates name.
/// Caller should then ensure the element is added to the XmlDocument in the appropriate location.
/// </summary>
internal static ProjectPropertyElement CreateDisconnected(string name, ProjectRootElement containingProject)
{
XmlUtilities.VerifyThrowArgumentValidElementName(name);
ErrorUtilities.VerifyThrowInvalidOperation(XMakeElements.IllegalItemPropertyNames[name] == null && !ReservedPropertyNames.IsReservedProperty(name), "OM_CannotCreateReservedProperty", name);
XmlElementWithLocation element = containingProject.CreateElement(name);
return(new ProjectPropertyElement(element, containingProject));
}
/// <summary>
/// Creates an unparented ProjectOnErrorElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectOnErrorElement CreateDisconnected(string executeTargets, ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.onError);
ProjectOnErrorElement onError = new ProjectOnErrorElement(element, containingProject);
onError.ExecuteTargetsAttribute = executeTargets;
return(onError);
}
/// <summary>
/// Creates an unparented ProjectPropertyGroupElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static ProjectWhenElement CreateDisconnected(string condition, ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.when);
ProjectWhenElement when = new ProjectWhenElement(element, containingProject);
when.Condition = condition;
return(when);
}
/// <summary>
/// Creates an unparented ProjectMetadataElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectMetadataElement CreateDisconnected(string name, ProjectRootElement containingProject)
{
XmlUtilities.VerifyThrowArgumentValidElementName(name);
ErrorUtilities.VerifyThrowArgument(!FileUtilities.ItemSpecModifiers.IsItemSpecModifier(name), "ItemSpecModifierCannotBeCustomMetadata", name);
ErrorUtilities.VerifyThrowInvalidOperation(XMakeElements.IllegalItemPropertyNames[name] == null, "CannotModifyReservedItemMetadata", name);
XmlElementWithLocation element = containingProject.CreateElement(name);
return new ProjectMetadataElement(element, containingProject);
}
/// <summary>
/// Creates an unparented ProjectOnErrorElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectOnErrorElement CreateDisconnected(string executeTargets, ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.onError);
ProjectOnErrorElement onError = new ProjectOnErrorElement(element, containingProject);
onError.ExecuteTargetsAttribute = executeTargets;
return onError;
}
/// <summary>
/// Creates an unparented ProjectImportElement, wrapping an unparented XmlElement.
/// Validates the project value.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static ProjectImportElement CreateDisconnected(string project, ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.import);
ProjectImportElement import = new ProjectImportElement(element, containingProject);
import.Project = project;
return import;
}
/// <summary>
/// Creates an unparented ProjectMetadataElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectMetadataElement CreateDisconnected(string name, ProjectRootElement containingProject)
{
XmlUtilities.VerifyThrowArgumentValidElementName(name);
ErrorUtilities.VerifyThrowArgument(!FileUtilities.ItemSpecModifiers.IsItemSpecModifier(name), "ItemSpecModifierCannotBeCustomMetadata", name);
ErrorUtilities.VerifyThrowInvalidOperation(!XMakeElements.ReservedItemNames.Contains(name), "CannotModifyReservedItemMetadata", name);
XmlElementWithLocation element = containingProject.CreateElement(name);
return(new ProjectMetadataElement(element, containingProject));
}
/// <summary>
/// Creates an unparented ProjectItemElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectItemElement CreateDisconnected(string itemType, ProjectRootElement containingProject)
{
XmlUtilities.VerifyThrowArgumentValidElementName(itemType);
ErrorUtilities.VerifyThrowArgument(XMakeElements.IllegalItemPropertyNames[itemType] == null, "CannotModifyReservedItem", itemType);
XmlElementWithLocation element = containingProject.CreateElement(itemType);
ProjectItemElement item = new ProjectItemElement(element, containingProject);
return(item);
}
/// <summary>
/// Creates an implicit ProjectImportElement as if it was in the project.
/// </summary>
/// <returns></returns>
internal static ProjectImportElement CreateImplicit(string project, ProjectRootElement containingProject, ImplicitImportLocation implicitImportLocation, SdkReference sdkReference)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.import);
return(new ProjectImportElement(element, containingProject)
{
Project = project,
Sdk = sdkReference.ToString(),
ImplicitImportLocation = implicitImportLocation,
ParsedSdkReference = sdkReference
});
}
/// <summary>
/// Creates an unparented ProjectItemDefinitionElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectItemDefinitionElement CreateDisconnected(string itemType, ProjectRootElement containingProject)
{
XmlUtilities.VerifyThrowArgumentValidElementName(itemType);
// Orcas inadvertently did not check for reserved item types (like "Choose") in item definitions,
// as we do for item types in item groups. So we do not have a check here.
// Although we could perhaps add one, as such item definitions couldn't be used
// since no items can have the reserved itemType.
XmlElementWithLocation element = containingProject.CreateElement(itemType);
return(new ProjectItemDefinitionElement(element, containingProject));
}
/// <summary>
/// Creates an unparented UsingTaskParameterElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectUsingTaskParameterElement CreateDisconnected(string parameterName, string output, string required, string parameterType, ProjectRootElement containingProject)
{
XmlUtilities.VerifyThrowArgumentValidElementName(parameterName);
XmlElementWithLocation element = containingProject.CreateElement(parameterName);
ProjectUsingTaskParameterElement parameter = new ProjectUsingTaskParameterElement(element, containingProject);
parameter.Output = output;
parameter.Required = required;
parameter.ParameterType = parameterType;
return(parameter);
}
/// <summary>
/// Creates a non-parented ProjectSdkElement, wrapping an non-parented XmlElement.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static ProjectSdkElement CreateDisconnected(string sdkName, string sdkVersion,
ProjectRootElement containingProject)
{
var element = containingProject.CreateElement(XMakeElements.sdk);
var sdkElement = new ProjectSdkElement(element, containingProject)
{
Name = sdkName,
Version = sdkVersion
};
return(sdkElement);
}
/// <summary>
/// Creates an unparented ProjectUsingTaskBodyElement, wrapping an unparented XmlElement.
/// Validates name.
/// Caller should then ensure the element is added to the XmlDocument in the appropriate location.
/// </summary>
internal static ProjectUsingTaskBodyElement CreateDisconnected(string evaluate, string body, ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.usingTaskBody);
ProjectUsingTaskBodyElement taskElement = new ProjectUsingTaskBodyElement(element, containingProject);
taskElement.Evaluate = evaluate;
taskElement.TaskBody = body;
return taskElement;
}
/// <summary>
/// Creates an unparented ProjectExtensionsElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static ProjectExtensionsElement CreateDisconnected(ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.projectExtensions);
return(new ProjectExtensionsElement(element, containingProject));
}
/// <summary>
/// Creates an unparented ProjectOtherwiseElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectOtherwiseElement CreateDisconnected(ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.otherwise);
return(new ProjectOtherwiseElement(element, containingProject));
}
/// <summary>
/// Creates an unparented ProjectOutputElement, wrapping an unparented XmlElement.
/// Validates the parameters.
/// Exactly one of item name and property name must have a value.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static ProjectOutputElement CreateDisconnected(string taskParameter, string itemType, string propertyName, ProjectRootElement containingProject)
{
ErrorUtilities.VerifyThrowArgument
(
(String.IsNullOrEmpty(itemType) ^ String.IsNullOrEmpty(propertyName)),
"OM_EitherAttributeButNotBoth",
XMakeElements.output,
XMakeAttributes.propertyName,
XMakeAttributes.itemName
);
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.output);
ProjectOutputElement output = new ProjectOutputElement(element, containingProject);
output.TaskParameter = taskParameter;
if (!String.IsNullOrEmpty(itemType))
{
output.ItemType = itemType;
}
else
{
output.PropertyName = propertyName;
}
return output;
}
/// <summary>
/// Creates an unparented ProjectExtensionsElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static ProjectExtensionsElement CreateDisconnected(ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.projectExtensions);
return new ProjectExtensionsElement(element, containingProject);
}
/// <summary>
/// Creates an unparented ProjectTargetElement, wrapping an unparented XmlElement.
/// Validates the name.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectTargetElement CreateDisconnected(string name, ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.target);
ProjectTargetElement target = new ProjectTargetElement(element, containingProject);
target.Name = name;
return target;
}
/// <summary>
/// Creates an unparented ProjectItemGroupElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to the XmlDocument in the appropriate location.
/// </summary>
internal static ProjectItemGroupElement CreateDisconnected(ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.itemGroup);
return new ProjectItemGroupElement(element, containingProject);
}
/// <summary>
/// Creates an unparented UsingTaskParameterElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectUsingTaskParameterElement CreateDisconnected(string parameterName, string output, string required, string parameterType, ProjectRootElement containingProject)
{
XmlUtilities.VerifyThrowArgumentValidElementName(parameterName);
XmlElementWithLocation element = containingProject.CreateElement(parameterName);
ProjectUsingTaskParameterElement parameter = new ProjectUsingTaskParameterElement(element, containingProject);
parameter.Output = output;
parameter.Required = required;
parameter.ParameterType = parameterType;
return parameter;
}
/// <summary>
/// Creates an unparented ProjectTaskElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to the XmlDocument in the appropriate location.
/// </summary>
/// <remarks>
/// Any legal XML element name is allowed. We can't easily verify if the name is a legal XML element name,
/// so this will specifically throw XmlException if it isn't.
/// </remarks>
internal static ProjectTaskElement CreateDisconnected(string name, ProjectRootElement containingProject)
{
ErrorUtilities.VerifyThrowArgumentLength(name, "name");
XmlElementWithLocation element = containingProject.CreateElement(name);
return new ProjectTaskElement(element, containingProject);
}
/// <summary>
/// Creates an unparented ProjectUsingTaskElement, wrapping an unparented XmlElement.
/// Validates the parameters.
/// Exactly one of assembly file and assembly name must have a value.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static ProjectUsingTaskElement CreateDisconnected(string taskName, string assemblyFile, string assemblyName, string runtime, string architecture, ProjectRootElement containingProject)
{
ErrorUtilities.VerifyThrowArgument
(
(String.IsNullOrEmpty(assemblyFile) ^ String.IsNullOrEmpty(assemblyName)),
"OM_EitherAttributeButNotBoth",
XMakeElements.usingTask,
XMakeAttributes.assemblyFile,
XMakeAttributes.assemblyName
);
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.usingTask);
ProjectUsingTaskElement usingTask = new ProjectUsingTaskElement(element, containingProject);
usingTask.TaskName = taskName;
usingTask.Runtime = runtime;
usingTask.Architecture = architecture;
if (!String.IsNullOrEmpty(assemblyFile))
{
usingTask.AssemblyFile = assemblyFile;
}
else
{
usingTask.AssemblyName = assemblyName;
}
return usingTask;
}
/// <summary>
/// Creates an unparented ProjectPropertyElement, wrapping an unparented XmlElement.
/// Validates name.
/// Caller should then ensure the element is added to the XmlDocument in the appropriate location.
/// </summary>
internal static ProjectPropertyElement CreateDisconnected(string name, ProjectRootElement containingProject)
{
XmlUtilities.VerifyThrowArgumentValidElementName(name);
ErrorUtilities.VerifyThrowInvalidOperation(XMakeElements.IllegalItemPropertyNames[name] == null && !ReservedPropertyNames.IsReservedProperty(name), "OM_CannotCreateReservedProperty", name);
XmlElementWithLocation element = containingProject.CreateElement(name);
return new ProjectPropertyElement(element, containingProject);
}
/// <summary>
/// Creates an unparented UsingTaskParameterGroupElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static UsingTaskParameterGroupElement CreateDisconnected(ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.usingTaskParameterGroup);
return(new UsingTaskParameterGroupElement(element, containingProject));
}
/// <summary>
/// Creates an unparented ProjectItemElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectItemElement CreateDisconnected(string itemType, ProjectRootElement containingProject)
{
XmlUtilities.VerifyThrowArgumentValidElementName(itemType);
ErrorUtilities.VerifyThrowArgument(XMakeElements.IllegalItemPropertyNames[itemType] == null, "CannotModifyReservedItem", itemType);
XmlElementWithLocation element = containingProject.CreateElement(itemType);
ProjectItemElement item = new ProjectItemElement(element, containingProject);
return item;
}
/// <summary>
/// Creates an unparented ProjectOtherwiseElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectOtherwiseElement CreateDisconnected(ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.otherwise);
return new ProjectOtherwiseElement(element, containingProject);
}
internal static ProjectItemDefinitionGroupElement CreateDisconnected(ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.itemDefinitionGroup);
return(new ProjectItemDefinitionGroupElement(element, containingProject));
}
/// <summary>
/// Creates an unparented ProjectItemDefinitionElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent.
/// </summary>
internal static ProjectItemDefinitionElement CreateDisconnected(string itemType, ProjectRootElement containingProject)
{
XmlUtilities.VerifyThrowArgumentValidElementName(itemType);
// Orcas inadvertently did not check for reserved item types (like "Choose") in item definitions,
// as we do for item types in item groups. So we do not have a check here.
// Although we could perhaps add one, as such item definitions couldn't be used
// since no items can have the reserved itemType.
XmlElementWithLocation element = containingProject.CreateElement(itemType);
return new ProjectItemDefinitionElement(element, containingProject);
}
/// <summary>
/// Creates an unparented UsingTaskParameterGroupElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static UsingTaskParameterGroupElement CreateDisconnected(ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.usingTaskParameterGroup);
return new UsingTaskParameterGroupElement(element, containingProject);
}
/// <summary>
/// Creates an unparented ProjectPropertyGroupElement, wrapping an unparented XmlElement.
/// Caller should then ensure the element is added to a parent
/// </summary>
internal static ProjectWhenElement CreateDisconnected(string condition, ProjectRootElement containingProject)
{
XmlElementWithLocation element = containingProject.CreateElement(XMakeElements.when);
ProjectWhenElement when = new ProjectWhenElement(element, containingProject);
when.Condition = condition;
return when;
}