# WithReference

- Module: [Aspire.Hosting](/reference/api/go/aspire.hosting.md)
- Version: `17.0.0`
- Kind: `method`
- Defined on: [`ResourceWithEnvironment`](/reference/api/go/aspire.hosting/resourcewithenvironment.md)
- Source: [GitHub](https://github.com/microsoft/aspire/tree/bcfa151cdca6d0a573f22d5d9c23f9c727cb3b2f)

Adds a reference to another resource

## Definition

```go
func (ResourceWithEnvironment) WithReference(
    source any,
    options ...*WithReferenceOptions,
) ResourceWithEnvironment
```

## Parameters

- `source` (`any`)
- `options` (`...*WithReferenceOptions`) -- optional settings, see [Options](#options)

## Options

Optional parameters are passed in a trailing `options ...*WithReferenceOptions` argument.

- `ConnectionName` (`*string`)
- `Optional` (`*bool`)
- `Name` (`*string`)

## Returns

[`ResourceWithEnvironment`](/reference/api/go/aspire.hosting/resourcewithenvironment.md)

Returns a handle; failures surface later via `Err()`.

## Applies to

- [`CSharpAppResource`](/reference/api/go/aspire.hosting/csharpappresource.md)
- [`ContainerResource`](/reference/api/go/aspire.hosting/containerresource.md)
- [`DotnetToolResource`](/reference/api/go/aspire.hosting/dotnettoolresource.md)
- [`ExecutableResource`](/reference/api/go/aspire.hosting/executableresource.md)
- [`ProjectResource`](/reference/api/go/aspire.hosting/projectresource.md)
