---
title: "system.vision.refreshBinding"
description: "This function will programmatically cause a SQL Query or DB Browse property binding to execute immediately."
---

# system.vision.refreshBinding

> This function will programmatically cause a SQL Query or DB Browse property binding to execute immediately.

:::info Backwards Compatibility
This function replaces [system.db.refresh](versioned_docs/version-8.1/appendix/scripting-functions/system-db/system-db-refresh.md). Any scripts containing Vision Client scoped functions that were replaced with system.vision syntax will still work to maintain backwards compatibility.
:::

This function is used in **Python Scripting**.

## Description

This function will cause a Vision component binding to execute immediately. This is most often used for bindings that are set to  Polling - Off.  In this way, you cause a binding to execute on demand, when you know that the results of its query will return a new result. To use it, you simply specify the component and name of the property on whose binding you'd like to refresh.

This function can update all types of Vision component bindings, including Property and Expression bindings.

:::note
Note: This function will only work within the Vision module. To manually execute bindings in Perspective, use the [refreshBinding](ignition-modules\perspective\scripting-in-perspective\perspective-component-methods.md#refreshing-bindings) component method.
:::

## Client Permission Restrictions

[Permission Type](ignition-modules\vision\vision-project-properties\vision-project-properties.md#vision-permissions-properties): Legacy Database Access

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.

## Syntax

`system.vision.refreshBinding(component, propertyName)`

### Parameters
Type | Parameter | Description 
------- | ------- | -----
JComponent| `component` | The component whose property you want to refresh.
String| `propertyName` | The name of the property that has a SQL Query binding that needs to be refreshed.

### Returns
**Boolean** - True if the property was found and refreshed successfully.

### Scope
Vision Client

## Code Examples

```python title="Code Snippet - Refreshing a Table's Data Property"
# This example could be placed in the actionPerformed event of a Button,
# to be used to refresh the data of a Table. 
# Remember to use the scripting name of the property that you're trying to refresh,
# and that the property names are case-sensitive.
  
table = event.source.parent.getComponent("Table")
system.vision.refreshBinding(table, "data")
```