---
title: "Create String Builder File Based"
slug: "create-string-builder-file-based"
tags: ["string builder", "files"]
updated: 2022-12-15T19:30:46Z
published: 2022-12-15T19:30:46Z
canonical: "documentation.decisions.com/create-string-builder-file-based"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create String Builder File Based

| ## Step Details |
| --- |
| **Introduced in Version** | 4.0.0 |
| **Last Modified in Version** | 5.0.0 |
| **Location** | Data > Text > String Builder |

The **Create String Builder File Based** step created a String Builder text file in the specified directory.

---

## Properties

#### Inputs

| Property | Description | Data Type |
| --- | --- | --- |
| Temp Directory Name | Directory path for the String Builder file | String |

#### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| Output | Text file | StringBuilderData |

---

## Example Inputs and Outputs

| Input | Output |
| --- | --- |
| c:\temp | c:\temp\98c440c4-8665-4e76-87c1-fe8e2d73780b.txt |
| Null | EXCEPTION MESSAGE |
| C:\Users\Folder1 | C\Users\Folder1\4ef9a47b-86d6-4ad9-829d-637a35ac6ccb.txt |
| " " | EXCEPTION MESSAGE |

#### ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1671130964336.png)

---

## Common Errors

### Path cannot be the empty string or all whitespace

If the input does not contain a value, an error will occur. To correct this, ensure that the input value is entered/mapped correctly.

#### Exception Message:

```csharp
Exception Stack Trace: DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Create String Builder File Based 1[CreateStringBuilderFileBased] in flow [Flow 2]: Exception invoking method CreateStringBuilderFileBased on class StringBuilderSteps
 ---> DecisionsFramework.LoggedException: Exception invoking method CreateStringBuilderFileBased on class StringBuilderSteps
 ---> System.ArgumentException: Path cannot be the empty string or all whitespace. (Parameter 'path'
 at System.IO.Directory.CreateDirectory(String path
 at DecisionsFramework.Design.Flow.CoreSteps.StandardSteps.StringBuilderSteps.CreateStringBuilderFileBased(String tempDirectoryName)
   --- End of inner exception stack trace --- at DecisionsFramework.Design.Flow.StepImplementations.InvokeMethodStep.Run(StepStartData data
 at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData
 at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData)
   --- End of inner exception stack trace ---
```

---

### Value cannot be null

If the input is null, an error will occur. To correct this, ensure that the input value is entered/mapped correctly.

#### Exception Message:

```csharp
Exception Stack Trace: DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Create String Builder File Based 1[CreateStringBuilderFileBased] in flow [Flow 2]: Exception invoking method CreateStringBuilderFileBased on class StringBuilderSteps
 ---> DecisionsFramework.LoggedException: Exception invoking method CreateStringBuilderFileBased on class StringBuilderSteps
 ---> System.ArgumentNullException: Value cannot be null. (Parameter 'path'
 at System.IO.Directory.CreateDirectory(String path
 at DecisionsFramework.Design.Flow.CoreSteps.StandardSteps.StringBuilderSteps.CreateStringBuilderFileBased(String tempDirectoryName)
   --- End of inner exception stack trace --- at DecisionsFramework.Design.Flow.StepImplementations.InvokeMethodStep.Run(StepStartData data
 at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData
 at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData)
   --- End of inner exception stack trace ---
```

---

## Related

- [String Builder Steps](/string-builder-steps-1.md)